Limited Warranty Information 

I. CUSTOMER OBLIGATION 

A. CUSTOMER assumes full responsibility that this computer hardware, (the "Equipment") 

and/or software (the "Software") meets the specifications, capacity, capabilities, versatility, r"^s 
and other requirements of CUSTOMER. A 

B. CUSTOMER assumes full responsibility for the condition and effectiveness of the 
operating environment in which the Equipment and Software is to function, and for its 
installation. 

II. RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 

A. For a period of ninety (90) calendar days from the date of the Radio Shack sales 
ticket, RADIO SHACK warrants to the original CUSTOMER that the Equipment and the cassettes 
and/or diskettes containing software programs are free from defects. This warranty is only 
applicable to purchases from RADIO SHACK company-owned Computer Centers, retail stores and 
through RADIO SHACK franchisees and dealers. The warranty is void if the unit's case or 
cabinet has been opened, or if the unit has been subjected to improper or abnormal use. If a 
defect occurs during the warranty period, the defective Equipment must be returned to a Radio 
Shack Computer Center, a Radio Shack retail store, participating franchisee or dealer for 
repair, along with a copy of the sales ticket or lease agreement. The original CUSTOMER'S sole 
and exclusive remedy in the event of a defect is limited to the correction of the defect by 
repair, replacement, or complete refund, at RADIO SHACK'S election and sole expense. RADIO 
SHACK has no obligation to replace or repair expendable items. 

B. RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability 
for use of the Equipment or Software. Software is licensed on an "AS IS" basis, without 
warranty. CUSTOMER'S exclusive remedy, in the event of a software defect is its repair or 
replacement within thirty (30) calendar days of the date of purchase upon its return to a Radio 
Shack Computer Center, Radio Shack retail store, participating franchisee or dealer along with 
the sales ticket. 

C. Except as provided herein no employee, agent, franchisee dealer or other person is 
authorized to give any warranties of any nature on behalf of RADIO SHACK. 

D. Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES OF 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 

F. Some states do not allow limitations on how long an implied warranty lasts, so the 
above limitation (s ) may not apply to CUSTOMER. 

III. LIMITATION OF LIABILITY 

A. EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO 
CUSTOMER OR ANY OTHER PERSON OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR 
ALLEGED BE CAUSED DIRECTLY OR INDIRECTLY BY "EQUIPMENT" OR "SOFTWARE" SOLD, LEASED, LICENSED OR 
FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY INTERRUPTION OF SERVICE, LOSS OF 
BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR OPERATION 
OF THE "EQUIPMENT" OR "SOFTWARE." IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, 
OR ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY 

OR IN ANY MANNER ARISING OUT OF OR CONNECTED WITH THE SALE, LEASE, USE OR ANTICIPATED USE OF /~~\. 

THE "EQUIPMENT" OR SOFTWARE". ' 

NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK'S LIABILITY HEREUNDER N / 

FOR DAMAGES INCURRED BY CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE 
PARTICULAR "EQUIPMENT" OR "SOFTWARE" INVOLVED. 

B. RADIO SHACK shall not be liable for any damages caused by delay in delivering or 
furnishing any Equipment or Software. 

C. No action arising our of any claimed breach of this WARRANTY or transactions under 
this WARRANTY may be brought more than two (2) years after the cause of action has accrued or 
more than four (4) years after the date of the Radio Shack sales ticket for the Equipment or 
Software whichever first occurs. 

D. Some states do not allow the exclusion or limitation of incidental or consequential 
damages, so the above limitation (s ) or exclusion(s) may not apply to CUSTOMER. 

IV. RADIO SHACK SOFTWARE LICENSE 

RADIO SHACK grants to CUSTOMER A non-exclusive, paid-up license to use the RADIO SHACK 
application or system Software and/or the RADIO SHACK system Software (including firmware) 
installed in or provided with the Equipment on one computer, subject to the following 
provisions : 

A. Except as otherwise provided in this Software License, applicable copyright laws 
shall apply to the Software. 

B. Title to the medium on which the Software is recorded (cassette and/or diskette) or 
stored (ROM) is transferred to CUSTOMER, but not title to the Software. 

C. CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for 
use on one computer and as is specifically provided in this Software License. 

D. CUSTOMER is permitted to make additional copies of the Software only for backup or 
archival purposes or if additional copies are required in the operation of one computer with 
the Software, but only to the extent the Software allows a backup copy to be made. 

E. CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER 
has purchased one copy of the Software for each one sold or distributed. The provisions of 
this Software License shall also be applicable to third parties receiving copies of the 
Software from CUSTOMER. 

F. All copyright notices shall be retained on all copies of the Software. 

V. APPLICABILITY OF WARRANTY 

A. The terms and conditions of this WARRANTY are applicable between RADIO SHACK and 
CUSTOMER to either a sale of the Equipment and/or Software License to CUSTOMER or to a 
transaction whereby RADIO SHACK sells or conveys such Equipment and/or Software to a third 
party for lease to CUSTOMER. 

B. The limitations of liability and warranty provisions herein shall insure to the 
benefit of RADIO SHACK, the owner and/or licensor of RADIO SHACK Software to RADIO SHACK, and 
any author or manufacturer of computer hardware or Equipment sold or Software licensed by RADIO 
SHACK. 

VII. STATE LAW RIGHTS 

The warranti.es granted herein give the original CUSTOMER specific legal rights, and the 
original CUSTOMER may have other rights which vary from state to state. 
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TRSDOS TM -II Operating System: Copyright 1982 Tandy Corporation. All 
Rights Reserved. 

TRSD0S T -16 Operating System: Copyright 1982 Ryan-McFarland Corporation. 
All Rights Reserved. Licensed to Tandy Corporation. 

EDIT16 Software: Copyright 1982 Ryan-McFarland Corporation. All Rights 
Reserved. Licensed to Tandy Corporation. 

ASM16 Software: Copyright 1982 Ryan-McFarland Corporation. All Rights 
Reserved. Licensed to Tandy Corporation. 

LINK16 Software: Copyright 1982 Ryan-McFarland Corporation. All Rights 
Reserved. Licensed to Tandy Corporation. 

TRS-80® Assembler-16 Programming Package: Copyright 1982 Tandy 
Corporation. All Rights Reserved. 

Reproduction or use without express written permission from Tandy Corporation, 
of any portion of this manual is prohibited. While reasonable efforts have 
been taken in the preparation of this manual to assure its accuracy, Tandy 
Corporation assumes no liability resulting from any errors or omissions in this 
manual, or from the use of the information obtained herein. 
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TO OUR CUSTOMERS... 

The Assembler-16 Programming Package contains three systems 
for developing programs in MC68000 object code: 

The EDITOR (EDIT16) which allows you to create 
and edit "source" assembly language programs 

The ASSEMBLER-16 (ASM16) which assembles 

the source program into an intermediate 68000 

object code program. 

The LINKER (LINK16) which links the intermediate 
object code program into an absolute executable 
program file. 

Also, as part of the TRSDOS-16, you can use: 

The DEBUGGER (DEBUG) for debugging the 
absolute program. 
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ABOUT THIS MANUAL 

This manual contains two sections: 

Section 1/ Operations explains how to use the 
four systems . 

Section 2/ Assembler-16 Reference Guide references 
the assembly language required by the Assembler-16 . 

The terms and notations the manual uses are: 

ALL CAPS 

indicates what will appear on your screen or what you 
should type. 

< KEYBOARD CHARACTER> 

indicates keys you press. 

lowercase underlined 

represents words, characters, or values to be supplied by 

you or the system. 

f ilespec 

is a standard TRSDOS-16 file specification, described in 
the TRSDOS-16 Manual, having the general form: 
f ilename / ext . password : drive ( disk name ) 

The notations and terms accepted by the Assembler-16 are in 
the beginning of Section 2. 
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CHAPTER 1/ SAMPLE SESSION 

This chapter shows how to use the Assembler-16 Programming 
Package to create, debug, and execute a 68000 object 
program. 

This is for demonstration purposes only. For complete 
information on each system's commands, listings, and error 
messages, see the appropriate chapter. 



DEVELOPING A 68000 PROGRAM 

To develop a 68000 program file, follow these steps: 

1. Create one or more source program files 
(with the Editor) 

2. Assemble the source files into intermediate 
object files (with the Assembler) 

3. Create a linker control file (with the Editor) 

4. Using the control file, link the intermediate 
files into an absolute program file (with the 
Linker ) 

1. Creating a Source File 

To create the source file, type: 

ED IT 16 < ENTER > 
which loads the Editor. At the C? prompt type: 

IN <ENTER> 

which enters the insert mode. At the I? prompt, insert this 
program: 

BEGIN LDA .A0,SVC BLOCK *load svc block 

MOVW §A0,#8 *store vdchar svc 

MOVW 6@AJ0,#65 *store 'A 

BRK #0 *execute vdchar 
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SVC BLOCK 



LDA 

MOVW 

BRK 

RDATAB 
END 



.AJ0 f SVC BLOCK 

@AJ0,#264 

#0 

32,J0 
BEGIN 



*load svc block 
*store jp2dos svc 
♦execute jp2dos svc 

♦reserve svc block 



Use <ENTER> to enter each line; <TAB> to tab between 
columns. (The Editor displays the <TAB> as an + character 
rather than tabbing.) 

This assembly language program contains Assembler-16 
instructions, described in Section II, and TRSDOS-16 
SVCs, described in the TRSDOS-16 Operating System Manual. 

If you need to edit the program, see Chapter 2. 
Otherwise, save it and exit the Editor with: 

! <ENTER> 

SAVE SAMPLE/SRC <ENTER> 

QUIT <ENTER> 

You should now have a source disk file named SAMPLE/SRC. 

Note: After using an SVC, you should normally 
check offsets 2 and 3 for an error code. For 
simplicity, this program does not do this. 



2. Assembling an Intermediate File 

To assemble SAMPLE/SRC, type: 

ASM16 SAMPLE <ENTER> 

which causes the Assembler to load and then assemble 
SAMPLE/SRC into "intermediate", relocatable object code, 

It then saves the intermediate code on disk as a file 
named SAMPLE/OBJ. 



3. Creating a Control File 

To create a linker control file, load the Editor and 
insert this program: 

INCLUDE SAMPLE 
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END 



INCLUDE and END are directives controlling the Linker 
(discussed in Chapter 4). 

SAVE this program as a file named SAMPLE/CTL and exit the 
Editor . 



4. Linking an Absolute Program File 

To link the program file, type (at TRSDOS-16 Ready): 

LINK16 SAMPLE <ENTER> 

which loads the Linker and then loads SAMPLE/CTL. 

The Linker links the one file which SAMPLE/CTL directs it 
to INCLUDE — SAMPLE/OBJ — to absolute addresses 
beginning with address 0000. (You could INCLUDE other 
intermediate files, as well.) 

The Linker saves this as an executable program file named 
SAMPLE . 

Refer to Chapter 4 for a complete listing of all the 
options to the linker command. 



EXECUTING THE PROGRAM 

Since SAMPLE is an absolute, executable program file, you 
can execute it from the TRSDOS-16 Ready mode. At 
TRSDOS-16 Ready, type: 

SAMPLE <ENTER> 

TRSDOS-16 loads and executes SAMPLE beginning at the 
"relative" address of 0000. 

Note that address 0000 is relative. TRSDOS-16 loads 
itself and the Debugger, if present, in an area of memory 
that is "invisible" to the user. The relative address of 
0000 is actually the first address available after 
TRSDOS-16 and the Debugger. 
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Because TRSDOS-16 uses relative addresses, you need not 
be concerned about loading your program over system 
memory . 



DEBUGGING THE PROGRAM 

If you need to debug the program, you can use the 
Debugger. At TRSDOS-16 Ready, type: 

DEBUG ON <ENTER> 
SAMPLE < ENTER > 

which turns on the Debugger and then loads SAMPLE. If 
the Debugger does not activate, you will need to 
configure it into system memory. Appendix D explains 
how. 

Once SAMPLE is loaded into the Debugger , you can use any 
of the Debugger commands . For example : 

N <ENTER> 
executes the SAMPLE'S first instruction. 

V 1A <ENTER> 
displays the contents of addresses 001A through ,0029 . 
To exit the Debugger and return to TRSDOS-16 Ready, type: 

< ENTER > 
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CHAPTER 1/ THE EDITOR 

The Editor is a set of commands that allows you to create 
and edit text files. 

You can use the Editor with: 

1. The Assembler-16 

2. The COBOL Compiler 

3. The TRSDOS-16 DO command and Configuration command 
file 

It allows you to: 

1. Create files. 

You can write your own programs and save them to disk for 
future use. 

2. Edit existing files. 

You can change the program lines or contents of a file. 

3. Combine files. 

You can combine multiple programs together into one program. 



LOADING THE EDITOR 

This command, typed at TRSDOS-16 Ready, loads the Editor: 

EDIT16 source filespec { options } 

source filespec is optional. It causes the Editor to 
CONCATenate the specified source filespec . 

The options are: 

W= drive tells the Editor which drive to use as its 

work file. 
M= drive tells the Editor which drive to use as a 
"scratch file" during a MOVE. 
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WORK AND SCRATCH FILES 

W=drive 

As the Editor creates or edits a program, it does not use 

its own memory to do so. It stores your program on disk in 

a temporary "work file". You must have enough space on disk 

for this file, otherwise you get a disk-full error. 

The W=drive option tells the Editor which diskette to use 
for the work file. In this way you can save your good 
diskettes from excessive writes and deletions. 

If drive is not a valid drive specification, EDIT16 will 
not load and you will be returned to TRSDOS-16 Ready. 



M= drive 

When you use the Editor's MOVE command, the Editor creates 
another temporary disk file called a "scratch file". 

The M=drive option tells the Editor which diskette to use 
as its "scratch file". Again, this will save wear and tear 
on your good diskettes and files. 

If drive is not a valid drive specification, the Editor 
will use the first available drive for the scratch file. 



SAMPLE SESSION 

To enter the Editor, type: 

ED IT 16 <ENTER> 
and the Editor displays the prompt: 

C? 



This is the Editor's Command mode. You can use any of the 
Editor's commands in this mode. 

To create a program in the Editor, you must get in the 
Insert mode. At the C? prompt, type: 

IN <ENTER> 



Radio /hack 



18 



ASSEMBLER-16 TRS-SO ® THE EDITOR 



The Editor displays the I? prompt — indicating the Insert 
mode. Type in the following program lines. The asterisk 
(*) indicates comment lines: 

* THIS IS A PROGRAM < ENTER > 

* THAT WILL DEMONSTRATE <ENTER> 

* ALL OF THE TRSDOS-16 <ENTER> 

* EDITOR'S COMMANDS <ENTER> 
<ENTER> 

When you press <ENTER>, the Editor exits the Insert mode. 
The Editor keeps this file in its work file until you delete 
the lines, SAVE the file, or exit the Editor. 

To see what you've just entered in the Editor's work file, 
type: 

LIST ALL <ENTER> 

and the Editor returns a complete program listing: 

* THIS IS A PROGRAM 

* THAT WILL DEMONSTRATE 

* ALL OF THE TRSDOS-16 

* EDITOR'S COMMANDS 

Notice there are no line numbers in this program. To give 
it line numbers, you must first save your program by typing: 

SA SAMPLE 1/ PRO <ENTER> 

This writes the program as SAMPLEl/PRO to disk. 

After saving the program, delete all information from the 
Editor's work file by typing: 

DE ALL < ENTER > 

(The Editor prompts you with CANCEL = 'X 1 ; type <ENTER> to continue 
the DElete command. See DELETE for details.) 

Next type: 

CO SAMPLEl/PRO <ENTER> 
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to load — CONCATenate — the program into the Editor's work 
file. (See the appropriate Editor's command for details on 
its use. ) 

Your program is now in the Editor's work file with numbers: 

1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 

An alternate way to load your program into the work file 
(after you've SAVEd it) is to exit the Editor. Type: 

QU <ENTER> 

Then reload the Editor and the file at the same time by 
typing: 

EDIT16 SAMPLE1/PR0 <ENTER> 



LINE NUMBERING 



The Editor provides for two types of line numbrs 

relative line numbers 
absolute line numbers 



Relative line numbers 

When you initially create a program, the Editor does not 
assign line numbers. You can reference these unnumbered 
lines via relative line numbers. 

Relative line numbers are: 

$ the current line 

$-n the current line minus n lines 

$+n the current line plus n lines 

For example, to refer to a line five lines before the 
current line, use the relative line number $-5. To refer to 
a line nine lines after the current line, use $+9. 
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Absolute line numbers 

An absolute line number is the actual number which the 
Editor gives a line when you first CONCATenate the file into 
a work file. 

An "absolute line number" can be: 

a whole number, including zero (J0) 

START 

END 

Whenever the Editor concatenates a file into an empty work 
file, it assigns each line a whole number beginning with 1. 

Although the Editor never assigns a line 0, you can use it 
to insert lines at the beginning of the program. The 
commands CONCATenate, MOVE, and INSERT are the only ones 
that recognize a reference to line 0. 

START and END refer specifically to the first or last line 
of the program. 



REFERENCING PROGRAM LINES 

The following commands allow you to specify one line or a 
group of lines. 



line 

refers to a single line of the program. This single line 
can be either an "absolute line number" or a "relative line 
number " . 

Some examples of line as an absolute line number are: 

START Refers to first line of program 

23 Refers to line number 23 

1058 Refers to line number 1058 

END Refers to last line of program 

Refers to the line preceding the first 

line of the program 

Some examples of line as a relative line number are: 

$ Refers to the last line the work file 
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displayed — the current line 
$_7 Refers to the line that is seven lines 

before current line. 
$+6 Refers to line that is six lines after 

the current line. 



lines 

When you see lines in the command's syntax, you can enter: 

. One line 
to indicate a single line only. 

. ALL lines 
to indicate every line of the work file. 

. A pair of lines 

to indicate all lines between and including the pair of _ 
lines. To separate the line pair, use a comma (,), period 
( . ) , or hyphen (-) . 

When you specify a pair of lines, you cannot mix absolute 
and relative line numbers. For example: 

2-4 and $-2,$ 

are valid pairs of lines to reference. Both 2 and 4 are 
absolute line numbers. Both $-2 and $ are relative line 
numbers . 

$,2 and START-$ 

are not valid because $ and 2 and START and $ reference 
both relative and absolute line numbers within one pair. 

When specifying a pair of lines in a command, be sure to 
put the earliest line in the program first. You can use the 
pair $-6, $-4, but not $-4, $-6. 

Some more examples of pairs of lines are: 

START, 23 Refers to all lines from the first to 

line 23. 
971-1023 Refers to lines 971 through 1023 . 
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ALL 
$-7, $-2 



14 6, END 
$.$+3 



START . END 



Refers to the entire contents of the 

work file. 

Refers to the lines from the seventh 

before the current line to the 

second before the current line. 

Refers to lines 146 to the end. 

Refers to the lines from the current 

line to the line three lines after the 

current line. 

Refers to the entire contents of the 

work file. 



SPECIFYING STRINGS 

Three more terms to know when specifying a string to search 
for are: 

delimiter indicates a character used to mark the 

beginning and end of distinct variables. 

string indicates a set of characters. These can be 

any alphanumeric characters including 
blanks . 

G indicates a Global search. When G is 

specified, the Editor will search for each 
occurrence of the specified string within 
the given range. Without G, the Editor 
stops at the first occurrence of string. 



USING THE <BREAK> KEY 

You can use the <BREAK> key in the Editor with these commands 



CONCAT 


SAVE 


LIST 


SEARCH 


MOVE 


STRING 


PRINT 





When you press <BREAK> with any of these commands, the 
Editor will display the last line of operation and will 
return to the command mode — C? prompt. 

NOTE: Be careful when using <BREAK> with the SAVE and 
STRING commands. If you press <BREAK> while executing one 
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of these commands, part of the work file (with STRING) or 
the disk file (with SAVE) will be altered. 



ENTERING AN EDITOR COMMAND 

The following pages list all the Editor's commands. You 
may enter them by typing either: 

the entire command (SAVE FILE <ENTER>) 
the first two letters of the command (SA FILE 
< ENTER) 

Most commands allow you to specify an expression. 

If the expression begins with an alpha-character (A through 
Z), you must leave at least one blank space between the 
command and the expression (SA NEWFILE rather than 
SANEWFILE ) . 

If the expression begins with a number, you do not need to 
type an intervening space (both IN 100 and IN100 are 
correct ) . 
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CHANGE 

CH line 

allows you to change line . 

line is optional; if omitted, the Editor displays the 
current line for you to change. 

Once you enter this command, the Editor displays the I? 
prompt. To change the line, type the new line followed by 
< ENTER >. 

If you decide not to change the line, press <ENTER>. 



Examples 

With our sample program inserted, type (at the C? prompt): 

CH 1 <ENTER> 

and the Editor displays: 

1 * THIS IS A PROGRAM 
I? 

Change line 1 by typing: 

* THIS IS A NEW PROGRAM <ENTER> 

The Editor then displays the new line 1 and returns to the 
Editor ' s command mode . 
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CONCAT 

CO ( line ) filespec ( lines ) 

inserts (CONCATenates ) the contents of filespec into the 
Editor. 

line is optional and can only be used when the work file 
already contains a program. It indicates where in the work 
file to insert filespec . If omitted, filespec is 
inserted at the current position. 

lines is optional and tells the Editor to only CONCATenate 
the specified lines from filespec . If omitted, the entire 
file is inserted. 

Both line and lines must be enclosed in parentheses ( ) . 

Examples 

Before entering this example, delete everything in the work 
file by typing: 

DE ALL <ENTER> 

To CONCATenate SAMPLEl/PRO into the work file, type: 

CO SAMPLEl/PRO <ENTER> 

The Editor loads the file SAMPLEl/PRO from disk, displaying 
the last line with its new line number. 

To see the entire listing of the file, type LI ALL <ENTER> 
and the Editor displays: 

1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 

To CONCAT lines into a program already in the work file, 
type: 

CO (2) SAMPLEl/PRO (2-3) <ENTER> 

The Editor inserts lines two and three of SAMPLEl/PRO after 
the second line of the current program in the Editor. 
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(After the Editor CONCATenates lines, it displays the last 
of the lines being inserted.) 

Type LI ALL <ENTER> to see all of the Editor's contents: 

1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

* THAT WILL DEMONSTRATE 

* ALL OF THE TRSDOS-16 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 



When the Editor concatenates lines of a file into a program 
already in a work file, it doesn't add line numbers to the 
most recently CONCATenated lines. 
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DELETE 

DE lines 

deletes lines . 

If you do not specify lines , the Editor deletes the 
current line. 

If you specify lines as ALL, the Editor prompts you with: 
CANCEL = 'X 1 

Type X <ENTER> to cancel the DElete command. If you really 
do want to delete all the lines, press <ENTER>. 

Examples 

With the Editor's current position at the END of the work 
file, you can delete the two lines we inserted in the last 
example by typing: 

DE $-3, $-2 <ENTER> 

The program will again be: 

1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 

To delete the entire program, type: 

DE ALL <ENTER> 
Before actually deleting the lines, the Editor prompts: 

CANCEL = 'X' 

Type X <ENTER> to cancel the DElete ALL command. (If you 
really do want to delete all the lines, press <ENTER>). 
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INSERT 

IN line 

enters the Insert mode, displays the I? prompt, and allows 
you to insert lines after the referenced line . 

To terminate the Insert mode, type ! <ENTER> or simply 
<ENTER> at the beginning of an Insert line. The Editor will 
display the last line that you inserted, followed by the 
command mode prompt — C? . 

If you don't specify line , insertion begins after the 
current line. 



Examples 

If you have the sample program entered in the Editor and 
want to insert new lines after the fourth line, type: 

IN 4 <ENTER> 

The Editor displays : 

4 * EDITOR'S COMMANDS 

I? 



You are now in the Insert mode and can now insert lines 
after line 4. Type: 

BEGIN<TAB>LD<TAB>.A,0,#TABLE<TAB>*load start of table <ENTER> 
<TAB>BNE<TAB>DONE<TAB>*if no match go to DONE <ENTER> 
<ENTER> 

When you press the <TAB> key in the Insert mode, you'll see 
+_. This represents the <TAB> key. The tabstops are 
preset to multiples of eight, i.e., tabstops at 8, 16, 24, 
32, etc. (To set your own tabs, see the TAB command later 
in this chapter.) 

To see the tabbed inserted lines and the rest of the 
program, at the C? prompt, type: 

LI ALL <ENTER> 

and the Editor displays : 
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1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 
BEGIN LD .AJ0,#TABLE 

BNE DONE 



*load start of table 
*if no match go to DONE 



To insert lines at the beginning of a program, type: 
INjef <ENTER> 

you'll see the I? prompt. You can now insert lines which 
will precede the first line of the program. For example, 
type: 

* LET'S LOOK AT THE EDITOR <ENTER> 
<ENTER> 

This inserts * LET'S LOOK AT THE EDITOR as the first line of 
the sample program. 

To insert a line at the end of the program, type: 

IN END <ENTER> 

You can now add lines at the end of the program. Type: 

<TAB>M0V<TAB>.D2, .Dj2f+<TAB>*otherwise move element number <ENTER> 
< ENTER > 

to enter one more line. 

Save this new program by typing: 

SAVE SAMPLE2/PR0 <ENTER> 
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LIST 

LI lines 

displays lines and positions the Editor to the last line 
listed. 

lines is optional; if omitted, the Editor lists the 
current line. 

If you attempt to list more than 21 lines (more than the 
screen can display at one time), the Editor displays the 
first 21 lines and then returns the message: 

CANCEL = 'X' 

If you press <ENTER>, the display will continue. If you 
type X <ENTER>, the Editor stops the LISTing and returns to 
the command prompt . 

Examples 

LI ALL <ENTER> 

returns a complete listing of the current program. In this 
case, the Editor displays: 

* LET'S LOOK AT THE EDITOR 

1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 

BEGIN LD .AJ0,#TABLE *load start of table 

BNE DONE *if no match go to DONE 

MOVE . D2,.DJ2f *otherwise move element number 

To obtain a listing of the first unnumbered line at the 
beginning of the program, type: 

LIST START <ENTER> 

and the Editor returns this listing: 

* LET'S LOOK AT THE EDITOR 
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MO ( lines ) TO line 

duplicates lines and places them after line . 

lines is optional. If omitted, the Editor moves the 
current line. 

line is optional. If omitted, the Editor places lines 
after the current line. 

You must enclose lines with parentheses ( ) . If you do 
not, the Editor returns an error. 

Note: Use the DELETE command (See DELETE) if you want the 
MOVEd line(s) deleted from the original position in the 
file. 



Examples 

MO (START) TO END 

moves the first line of the program to the end of the 
program. 

MO (1-2)T0$ 

moves all lines between and including lines 1 and 2 to 
follow the current line. 

MO ($-2) TO $ 

moves the line two places before the current line to follow 
the current line. 

MO TO 4 

moves current line to follow line 4. 

MO 

moves current line to follow current line. (Has the effect 
of repeating the current line). 
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Use the DElete command to get rid of any of the lines you 
iMOved that you don't want duplicated in your program. First 
LI ALL lines, then type: 

DE$-3,$ <ENTER> 
DE$-3 <ENTER> 
DE$-3 <ENTER> 

This returns the program to the contents we will reference 
in the remainder of this section. 
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POSITION 

PO + n 
PO - n 

moves the Editor's current position plus (+) or minus (-) 
n lines and then displays the new current line. 

Typing PO is optional; if you simply type +n or -n, you 
can position the Editor. 

n is optional. If you specify it, n can be any whole 
number. If n is greater than the number of lines in the 
program, the Editor returns: 

**ITEM NOT FOUND** 

and moves the current position to the beginning or end of 
the program (beginning if you specified minus (-), end if 
you specified plus (+)). 

If you do not specify n, the Editor uses 1. 

Once you enter the position command, whenever you simply 
press <ENTER>, the Editor will move one line forward or 
backward, depending on the Position command you originally 
entered. To exit this command, enter another of the 
Editor ' s commands . 

Examples 

Using the sample program, SAMPLE2/PR0, position the Editor 
to the end by listing the entire program. Type: 

LI ALL <ENTER> 
and the Editor displays the current program: 

* LET'S LOOK AT THE EDITOR 

1 * THIS IS A PROGRAM 

2 * THAT WILL DEMONSTRATE 

3 * ALL OF THE TRSDOS-16 

4 * EDITOR'S COMMANDS 

BEGIN LD .A0,#TABLE *load start of table 
BNE DONE *if no match go to DONE 
MOV . D2,.D0 *otherwise move element number 
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The Editor's position at this time is the last line of the 
program. To position the Editor to line 2, type: 

PO -5 < ENTER > 

The Editor displays: 

2 * THAT WILL DEMONSTRATE 

C? 



To position the Editor to line number 1, type: 

- < ENTER > 

and the Editor now displays : 

1 * THIS IS A PROGRAM 

C? 
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PRINT 

PR lines 

prints lines on the printer. 

lines is optional. If you omit lines , the Editor prints 
only the current line. 

If lines include absolute line numbers, the Editor prints 
them also. 

Before printing, PRINT moves the paper to the TOP OF FORM. 

Examples 

PR 2 <ENTER> 
prints line 2 on the printer. 

PR ALL <ENTER> 
prints the entire listing on the printer. 

PR <ENTER> 
prints the current line on the printer. 
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QUIT 

QU 

terminates the Editor and returns to TRSDOS-16. 

If you attempt to Quit the Editor without SAVEing the 
current work file, you'll see the prompt: 

**N0 FILES SAVED** 
**QUIT EDITOR? Y OR N** 

This warns you that you haven't saved the file you were 
working on. If you don't want to SAVE it, type: 

Y < ENTER > 

The Editor then terminates and returns to TRSDOS-16 Ready. 

If you do not want to exit the Editor without SAVEing your 
program, type: 

N <ENTER> 

You will now see the last line, followed by the Editor's 
command prompt. 

Examples 

QU <ENTER> 

(if you have saved your file) terminates the Editor and 
displays : 

** EDITOR TERMINATED** 

TRSDOS-16 Ready 
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RELABEL 

RE lines 

Sequentially reorders the local label numbers between two 
global label definition lines. (See the Assembler Reference 
Section for details on local and global labels.) 

If either of the lines you indicate does not contain a 
global label definition, the Assembler will use the next 
line which does contain one. 

When the Editor alters lines , it displays all altered 
lines followed by the last altered line. That is, it 
repeats the last line. 

Use this command only on source text that uses the local 
label format. 

Examples 

Type in the example program using local and global labels. 
(Be sure to first delete all lines currently in the Editor.) 

$1<TAB>DATAL<TAB>10 <ENTER> 
GLOBAL ONE <ENTER> 
$7<TAB>BE<TAB>$5 <ENTER> 
$5<TAB>BL<TAB>$7 <ENTER> 
GLOBAL TWO < ENTER > 
$0<TAB>NOP < ENTER > 
<TAB>LDA<TAB>.AJ0,$1 <ENTER> 
GLOBAL THREE <ENTER> 
! < ENTER > 

(After typing in this program, SAVE it, DElete ALL lines in 
the work file, and then CONCATenate it to have the Editor 
give it line numbers.) When you List it, the program now 
appears as : 



1 $1 


DATAL 


10 


2 GLOBAL 


ONE 




3 $7 


BE 


$5 


4 $5 


BLT 


$7 


5 GLOBAL 


TWO 




6 $0 


NOP 




7 


LDA 


.A 



.AJ0,$1 



8 GLOBAL THREE 
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The Editor would execute the following commands in these 
ways : 

RE1,8 <ENTER> 

causes the Editor to relabel all the local labels in the 
above program. 

(After executing each RElabel command, you'll have to first 
DElete all the contents of the work file, then 
re-CONCATenate the program to see the effect of each 
RELABLE . 

RE 2 <ENTER> 

The Editor does not relabel any lines. It returns **ITEM 
NOT FOUND** followed by the line that you specified. 

RE 1,2 <ENTER> 

No relabeling occurs. The Editor returns **ITEM NOT FOUND** 
followed by the last line you specified. 

RE 1-3 <ENTER> 
causes the Editor to relabel GLOBAL ONE's range only. 

RE 2,5 <ENTER> 
causes the Editor to relabel GLOBAL ONE's range only. 

RE 2-6 < ENTER > 

causes the Editor to relabel GLOBAL ONE's and GLOBAL TWO's 
ranges . 

RE 3.7 <ENTER> 

causes the Editor to relabel GLOBAL TWO's range only. 

RE ALL <ENTER> 

causes the Editor to relabel each GLOBAL RANGE in the 
program. 

When you RELABEL all of the program, it should be: 

1 $1 DATAL 10 

2 GLOBAL ONE 
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3 $1 BE $2 

4 $2 BLT $1 

5 GLOBAL TWO 

6 $1 NOP 

7 LDA .AJ0,$1 

8 GLOBAL THREE 
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SAVE 

SA ( lines ) f ilespec 

saves f ilespec to disk. 

lines is optional. If you omit it, the Editor saves all 
of the current program. 

If you do not specify filespec , the Editor saves the 
program under the most recently CONCATenated or SAVEd 
filespec. Before doing so, it displays the filename, 
followed by "CANCEL = 'X'". To cancel the SAve , type X 
<ENTER>; to continue the SAVE, press <ENTER>. 

Examples 

With the sample program — SAMPLE2/PR0 — CONCATenated in 
the work file, type: 

SAVE SAMPLE 2/ PRO < ENTER > 

The Editor SAVEs the program to disk, writing over any 
existing file with the same name. 

To SAVE only the first two lines of the program, type: 

SA (1,2) SAMPLE2/PR0 <ENTER> 
If you type: 

SA <ENTER> 
the Editor prompts you with: 

SAMPLE 2/ PRO 

CANCEL = 'X' 

If you want to discontinue the SAVE, type X <ENTER>; if you 
want to continue the SAVE, press <ENTER>. 
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SEARCH 

SE ( lines ) delimiter string delimiter G 

causes the Editor to search for string within the range of 
lines . 

lines is optional. If omitted, the Editor SEarches the 
current line only. You must enclose lines in parentheses 
( ). 

G is optional. When used, it tells the Editor to list all 
occurences of string within the range of lines . If not 
included, the Editor lists only the first occurrence of 
string . 

Examples 

CONCATenate SAMPLE2/PR0 into the empty Editor (every line 
has an absolute line number), and type: 

SE (1-2)*L00K* <ENTER> 

"*" is the delimiter. The Editor searches lines 1 and 2 for 
the string LOOK. Since you didn't specify G, the Editor 
displays only the first line containing LOOK. 

SE (ALL)*BNE*G <ENTER> 

The Editor searches all lines of the program for the string 
BNE and displays every line containing it followed by the 
current line. 
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STRING 

ST ( lines ) delimiter stringl delimiter string2 delimiter G 

searches lines of the program for stringl and replaces 
it with string2 . 

lines is optional; if omitted, the current line is used. 
You must enclose lines with parentheses ( ) . 

G is optional. When used, it tells the Editor to substitute 
stringl with string2 at every occurence of stringl within the 
range of lines . If you don't specify G, the Editor substitutes 
string2 for stringl at the first occurrence within the range of 
lines . 

stringl is optional. If you omit it, the Editor inserts 
string2 at the beginning of every line within the range of 
lines . 

string2 is optional. If you omit it, the Editor deletes 
stringl . 

Examples 

With SAMPLE2/PR0 still CONCATenated in the Editor's work 
file, type: 

ST(l-4)/THIS/THAT/G <ENTER> 

"/" is the delimiter. The Editor finds all occurrences (G 
is specified) of the string THIS and substitutes each with 
THAT. 

By typing: 

ST (ALL) /THAT /THIS/ <ENTER> 

the Editor finds all occurrences of the string THAT and 
replaces it with THIS, and stops at the first occurrence (no 
G specified) . 

ST/E// <ENTER> 

causes the Editor to search the current line for the string 
E. Since the second string is empty, it deletes E. 
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TA c , tabstopl , tabstop2 , . . . , 

allows you to set tabs for use in the Insert mode ( I? 
prompt ) . 

c can be any character that you choose to represent the 
tab. (except blank or $ ) . If you don't specify c, the 
Editor clears all tab stops. 

tabstopl , tabstop2 , .... are the positions where you set 
the tabs stops. You can specify up to eight tab stops, 
separating each with a comma. The first tab in a line is 
tabstopl , the second tabstop2 , etc. 

If you specify only the tab character, the Editor keeps all 
previous tab stops. In this way, you can change the tab 
character without altering the actual tab stops. This is 
especially useful when c is a character used in the text 
of an insert. 

To set a tab (at the Editor's commmand mode — C? ) , type TA 
followed by the tab character, a comma, then a string of tab 
stops (column number where you want to place tabs). You can 
enter up to eight tabs . 

You can also use the <TAB> key instead of the TABS command. 
Its tabstops are preset to multiples of eight (i.e., 8, 16, 
24, 32, etc.). 

When you enter <TAB> in the Insert mode, it displays a + 
character. In the Command mode, the Editor displays the 
actual tabbed spacing. 

Use the <TAB> key when you want the multiple of eight 
tabstops; otherwise set your own tabstops with the TAB 
command . 



When setting tab stops: 

1. If you don't specify any variables, tab stops are 
cleared. For example, TA <ENTER> clears all tab stops 

2. If you specify only the tab character, the actual tab 
stops remain the same. 
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3. The tab character can be any character except blank, $, 
or one included in the text. 

4. Remember where you set the tab stops because, when you 
use them in the Insert mode, the Editor does not 
display the actual tab spacing. 

5. Always set the maximum number of tabs that you'll 
want to use. For example, if you only set three 

tabs with the TA command, you can only reference three 
in the Insert mode. If you reference more than you 
set, the Editor deletes any information following the 
extra tab(s ) . 



You can use a tab character at any time in the Insert mode. 
For example, set tabs at 10, 20, and 35, with a slash (/) as 
the tab character, by typing: 

TA /, 10, 20, 35 <ENTER> 

Now you can use tabs in any lines you type in the Insert 
mode. To do so, simply type the slash (/) before the word 
or phrase you want tabbed. You can use as many tabs as you 
set with the TAb command. Type: 

BEGIN/LD/.Ajef,#TABLE/*load start of table <ENTER> 

Now the program line is set with tabs . Whenever the Editor 
displays this line, it does so with the contents of the line 
tabbed like this: 

BEGIN LD .AJ0,#TABLE *load start of table 



Examples : 

TA/,5,12,30 <ENTER> 

Sets tabs at columns 5, 12, and 30. The tab character is 
the / (slash) . 

TA ? < ENTER > 

Changes the tab character to ? (question mark) and keeps all 
previous tab stops (5,12, and 30) the same. 
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TA <ENTER> 
Clears all tabs 
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THE ASSEMBLER-16 
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CHAPTER 3/ THE ASSEMBLER-16 

The Assembler-16 assembles a source file into an 
intermediate, relocatable object code file. 

This Chapter explains how to operate the assembler. For 
information on the source format required by the Assembler, 
see Section II. 



THE ASSEMBLER COMMAND 

This command, typed at TRSDOS-16 Ready: 

ASM16 source filespec { options } comment 

loads the Assembler-16 and assembles the source filespec 
using the default options or the options you specify. 
(The options and default options are described below). 

If you omit the source filespec 's extension and include 
the disk identifier (drive or disk name), the Assembler-16 
uses the disk identifier instead of the extension. 

If you omit the source filespec 's extension and also omit 
the disk identifier, the Assembler-16 uses /SRC as the 
extension. 

You can use a source file produced by other editors, as 
well as the Assembler-16 ' s Editor, provided it is in one of 
these formats : 

(1) variable length record (VLR) with one statement 
per record preceded by a byte count (this is what 
the Editor in this package produces) 

(2) ASCII stream with one byte per record (an LRL of 
one) and each line terminated by a carriage 
return byte . 

(3) fixed length record (FLR) with one statement per 
record. 

The optional comment allows you to document the assembly. 
If you use the comment, you must enclose the options in 
braces {}. Otherwise, the braces are not required. 
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ASSEMBLER OPTIONS 

You can specify the one letter options in one of four ways: 

option switches the option ON 

option =Y switches the option ON 

option =N switches the option OFF 

option = drive switches the option ON using 

the specified drive 

You can separate each option with a comma, a space, or 
nothing (not separate them at all). 

The options and their defaults (what the Assembler-16 uses 
if you omit the option) are: 

C (Current Record Count) 

Displays the number of the record currently being assembled, 
The default is C=N. 

E (Errors Only) 

Produces a listing of only the records which generate an 
error, along with any any object produced, and the error 
message. The default is E=N. 

K (Keep Work Files) 

Keeps the Assembler-16 from deleting the work files. (See 
the W switch for an explanation of the work files.) This 
speeds up multiple assemblies, since the Assembler-16 will 
not have to create work files over and over again. The 
default is K=N. 



L (Listing File) 

Creates a listing disk file using the same filename as the 
source, with the extension /LST. The default is L=N. 



(Object File) 
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Generates an object file using the same filename as the 
source, with the extension /OBJ. The default is 0=Y. 

P (Print Listing) 

Prints the listing on the printer. The default is P=N. 

S (Short Listing) 

Truncates listing if the source is too long for a line (as 
opposed to wrapping-around) . The default is S=N. 



T (Terminal Listing) 

Prints the listing on the video display terminal. The 
default is T=Y. 



U (Uppercase Conversion) 

Converts lowercase letters to uppercase letters. This is 
useful for printers without lowercase. The source remains 
unchanged. The default is U=N. 



W (Work File Specification) 

Allows you to specify which drive the Assembler-16 should 
use for its work files. The default is W=0. W=N is not 
allowed. 

To save memory, the Assembler-16 creates two work files 
during the assembly for temporary storage. It names the 
files : 

ASMS000p_/WRK 
ASMPJ000p_/WRK 

(p is the partition number for multi-tasking environments. 
Multi-tasking will be available in a future release of 
TRSDOS-16. In a single-tasking environment, p=l.) 

The Assembler-16 stores this file in your primary drive 
(unless you use W= drive . ) When it finishes the assembly, 
it deletes the work files (unless you use K=N) . 
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EXAMPLE ASSEMBLER COMMAND 

This command, typed at TRSDOS-16 Ready: 

ASM16 FRED {C=Y,L, P, U,W=4 ,K} <ENTER> 

causes the Assembler-16 to assemble the source file named 

FRED/SRC and: 

. display a current record count on the screen (C=Y) 

. generate a listing file named FRED/LST (L) 

. generate an an object file named FRED/OBJ (the 

default of is 0=Y) 
. print the listing on the printer in all uppercase 

(P,U) 
. store the work files on drive 4 (W=4) 
. retain (not delete) the work files (K) 

THE ASSEMBLER LISTING 



1. Side-by-Side Listing Format 

The side-by-side listing starts on a new page. These are 
two examples of it : 

Example 1 : 

8234C 00E12F 43F8 743 * LDA .Al, /MIT25 LABEL4 

06E4+ 

Example 2 : 

600 000586 227C LDL .Al,#3 

00000003 

The meaning of the examples is as follows: 

Line 1 

columns 1-4 contains the source file line number in 

decimal notation (Example 1 is line 8234; 
Example 2 is line 600) 

column 5 tells whether the line is from the primary 

source filespec or a file which was 
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column 7-12 



column 14-17 



copied into it. (See the COPY directive 
in Chapter 9) : 

. a blank space indicates the line 

is from the primary file (Example 2) 
. the characters A-I indicate the line 
was copied. (Example 1 indicates 
the line was part of "C" , the third 
file copied into the program. ) 

contains the hexadecimal memory address 
where the operation word is stored. 
(Example 1 indicates the LDA instruction 

is at H'E12F; Example 2 
indicates LDL is at H'0586.) 

contains the hexadecimal operation word. 
(The lines immediately below it reflect the 
extensions.) (Example 1 indicates the 
operation word for LDA is 43 F8; Example 2 
indicates LDL is 227C) 

tells where the symbol used in the line (if 
any) was defined. (Example 1 indicates 
MIT25 LABEL4 was defined in line 743.) 

tells whether the symbol used in this line 
is from the primary file or copied. 

. a blank space indicates it was from 
the primary file (Examples 1 and 2 
both contain blank spaces in this 
column) 
. the letters A-I indicate the symbol 
was from a copied file. 

tells if the symbol used in the line is 

a backwards reference (defined in a previous 

line ) : 

. an asterisk (*) indicates it is a 

backwards reference 
. a blank space indicates it is a 
forwards reference 
(Example 1 indicates MIT25 LABEL4 was 
defined in a previous line.) 

column 26-end is the source line, printed with no reformatting, 

If the source line is long, the excess is 
printed right justified on the following line. 



columns 19-22 



column 23 



column 24 
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Line 2 



columns 10-17 



column 18 



is the extension of the operation word, 
right justified (Example 1 indicates the 
extension for the instruction is J06E4; 
Example 2 indicates a long extension of 
00000003 . ) 

is the relocation type of the symbol used in 
the line ( if any) : 

. a period ( . ) indicates it is external 

(defined by DEF) 
. a plus sign (+) indicates it is relocatable 

(defined in an RSECT) 
. a blank space indicates it is absolute 
(defined in an ASECT) 
(Example 1 indicates the symbol MIT25 LABEL4 is 
relocatable; Example 2 does not contain a symbol) 
See Chapter 9 for an explanation of the DEF, 
RSECT, and ASECT directives.) 



The Assembler-16 may print line 2 one to four times, depending on how 
many extensions the operation word uses. '"""""^ 

2. Error /Warning Messages 

The error and warning listing begins immediately after the 
side-by-side listing. These are examples of it: 



Example 1: 

2 000000 00000000 



1 



LOAD 



,D1, #32 



*** ERROR *** 1 UNKNOWN OPCODE 
*** ERROR *** 1 ILLEGAL STATEMENT 



Example 2: 

3 000004 



303C 



0020 



LD 



BlXYZ, #32 



*** ERROR *** 
** WARNING ** 



REGISTER SYMBOL REQUIRED BlXYZ 
WORD LENGTH ASSUMED 



Example 3 : 
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4 000008 
** WARNING ** 



323C 



LD 



0020 
WORD LENGTH ASSUMED 



.Dl, #32 



The meaning of each line is as follows; 



Line 1 
Line 2 

Line 3 

column 1-13 



is the line containing the error 

indicates with a dollar sign ($) the position 
of the errors or warnings. The Assembler-16 
uses this notation only where it is helpful. 

is the error message. Line 3 is repeated for 
each error in the source line. This is the 
meaning of each column in line 3: 

tells the type of message: 

*** ERROR *** (this causes the program not 
to assemble properly) 

** WARNING ** (this warns you that the 
Assembler-16 might not be interpreting 
your instruction as you want it to) 



column 15-16 



identifies which $ character the error message 
is referencing (Both messages in Example 1 indicate 
that they are referencing the first — actually 
the only — $ character) 

columns 18-end contains the error/warning message, followed by 
a blank space, followed by the associated symbol 
(if any). If the symbol is longer than space 
permits, it is truncated. 



List of Errors and Warnings 

CONSTANT OUT OF RANGE 
ILLEGAL BINARY CONSTANT 
ILLEGAL COPY STATEMENT 
ILLEGAL EXPRESSION 
ILLEGAL FORMAL 
ILLEGAL HEX CONSTANT 
ILLEGAL LOCAL 
ILLEGAL OCTAL CONSTANT 
ILLEGAL STRING DELIMITER 
ILLEGAL SYMBOL 
MISSING COMMA 



COPY FILE NOT FOUND 

FORM FIELDS SIZE ERROR 

ILLEGAL ORG EXPRESSION 

INCORRECT NUMBER OF EXPRESSIONS 

INDEXING NOT ALLOWED 

INVALID LOCAL 

LOCAL LABEL NOT ALLOWED 

NESTED COPY NOT ALLOWED 

OPERAND INCOMPATIBLE WITH INSTRUCTION 

REGISTER SYMBOL REQUIRED 

STATEMENT IGNORED 
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MISSING COMMENT SEPARATOR 
MISSING SEPARATOR 
SYMBOL REQUIRED 
UNKNOWN OP CODE 
MISSING RIGHT PAREN 
MISSING STRING TERMINATOR 
PACKED STRING NOT ALLOWED 
GLOBAL SYMBOL REQUIRED 
INVALID FORMAL REFERENCE 
INVALID GLOBAL SYMBOL 
LOCAL MULTIPLY DEFINED 
LOCAL UNDEFINED 
SYMBOL MULTIPLY DEFINED 
SYMBOL UNDEFINED: 
ABSOLUTE EXPRESSION REQUIRED 
ADDRESS REGISTER REQUIRED 



SYMBOL NOT POP 

TOO MANY COPY STATEMENTS 

USE OF ILLEGAL FORM SYMBOL 

VALUE NOT RELATIVE TO CURRENT PSECT 

VALUE OUT OF RANGE 

VALUE TRUNCATED 

BIT NUMBER OUT OF RANGE 

SHIFT VALUE OUT OF RANGE 

SMALLER LENGTH ATTRIBUTE ASSUMED 

WORD LENGTH ASSUMED 

DIVISION BY ZERO 

ILLEGAL STATEMENT 

REPEATED RLIST ELEMENT - IGNORED 

INCORRECT NUMBER OF OPERANDS 

DSECT SYMBOL REQUIRED 

RSECT SYMBOL REQUIRED 



3. Cross Reference Listing 

The cross reference listing starts on a new page 
example of it: 



LABELSCANHAVESINGLESPACESBUTDONTSHOWTHEM 

331 /MOV 336 /LD 
340 /LDL 343 /ADD 
376 /STB 

The meaning of it is as follows: 

Line 1 



This is an 
00000302 L+ 390C 



337 /STP 
344 /LD 



338 /XCH- 
356 /MOV 



columns 1-45 
column 56 



column 57 



is the first 45 nonblank characters of the 
symbol, with trailing blanks. 

is the length attribute of the symbol: 
L = Long 
W = Word 
B = Byte 
U = Undefined 

indicates where the symbol's relocation type: 

blank space = absolute (defined in a program 

section initialized by the ASECT directive) 
+ = relocatable (defined in a program 

section introduced by the RSECT directive) 
. = external (declared by the DEF directive) 
(If the program contains none of the above 
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directives, the Assembler-16 treats all the 
symbols as absolute.) 

columns 59-62 contains the source line number where the symbol 

is defined (**** indicates the symbol's undefined.) 

column 63 tells whether the symbol is from the primary 
source filespec or a copied file: 
blank space = primary file 
A-I = copied file 

Lines 2-n 

columns 30-33 contains the source line number where 
the symbol is referenced. 

column 34 tells whether that line is from a primary 
or copied file: 

blank space = primary file 
A-I = copied file 

columns 35-40 contains the source line's instruction 
preceded by a slash (/) 

The Assembler-16 lists line 2 as many times as there are 
references to the symbol. If there are no references, the 
Assembler-16 does not list line 2. Columns 30-41 are repeated 
across the entire width of the page. 

4. Statistics Listing 

The statistics listing is the final page of the listing. It 
lists the total ERROR and WARNING messages (in decimal notation). 

Example : 

STATISTICS OF THIS ASSEMBLY 

TOTAL NUMBER OF ERRORS 6 

TOTAL NUMBER OF WARNINGS 8 
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THE LINKER 
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CHAPTER 4/ THE LINKER 

The Linker (LINK16) links one or more "intermediate" files 
into an absolute program that the 68000 can execute. It 
does this in one pass. 

In addition, the Linker can load multiple object files, 
resolve undefined external references between the modules, 
and produce a single program file. 



PREPARING A LINKER CONTROL FILE 

Before using the Linker, you must prepare a Linker control 
file by: 

1. Creating an object file, and then 

2. Creating the control file 



1. Creating an Object File 

The object file is a file of intermediate, relocatable 
object code. You will normally use the Assembler-16 to 
create it . 

You can also create it with another assembler or compiler 
provided it produces the format required by the Linker. 
Appendix A describes the format. 



2. Creating the Control File 

The control file is a file of linker directives. You will 
normally use the Editor, as demonstrated in Chapter 1 to 
create it . 

You can also use other editors to create the file, provided 
it is in the format required by the Linker: 

(1) variable length record (VLR) with each record 
preceded by a byte count (this is what the Editor 
in this package produces.) 

(2) ASCII stream with one byte per record (an LRL 
of one) and each line terminated by a carriage 
return byte. 
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(3) fixed length record (FLR) with one record per 
statement. 

The directives you can use in creating this file are: 

END 

END 

ends the control file. If the Linker reaches the end of the 
file and does not encounter an END directive, it 
automatically supplies one. 

Example : 

END 

tells the Linker to stop reading the control file, finish 
producing the absolute program file, and return to 
TRSDOS-16 Ready. 

INCLUDE 

INCLUDE object f ilespec 

inputs the object f ilespec and links it to the existing 
program. 

If you omit the object f ilespec ' s extension, the Linker 
appends the extension /OBJ. However, if you omit the 
extension and include the drive, the Linker treats the drive 
as the extension. 

Example : 

INCLUDE FILEl 

causes the Linker to load FILEl/OBJ and link it to the 
current program. 

INCLUDE FILEl: 2 

causes the Linker to load FILEl/: 2 and link it to the 
current program. 

ORIGIN 
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ORIGIN address 

forces the next INCLUDEd filespec to be loaded beginning at 
the specified address . The Linker assumes this address 
is decimal unless it has either a leading '0' or * >', both 
of which imply hexadecimal. 

The Linker will not test for conflicts with previously 
loaded code. For example, if you specify the same ORIGIN 
address for two filespecs, the Linker will load one on top 
of the other without giving you a warning. 

If you omit ORIGIN, the Linker uses an originating address 
of 0000. 

Examples : 

ORIGIN 5000 

tells the Linker to use decimal 5000 as the originating 
address for the next INCLUDEd file. 

ORIGIN >1000 

tells the Linker to originate the next file at hexadecimal 
1000. 



Begins a comment line. The Linker will print it on the map, 
but otherwise ignore it. 

Example : 

*This is a comment 

is ignored by the Linker. 

THE LINKER COMMAND 

This command, typed at TRSDOS-16 Ready: 
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LINK16 control filespec { options } comment 

loads the Linker, executes the directives in the control 
filespec , and produces an absolute program file. The 

absolute program file will have the same name as the 
control filespec , minus the extension. 

If you omit the control filespec 's extension, the Linker 
appends the extension /CTL. However, if you omit the 
extension and include the drive, the Linker treats the drive 
as the extension. 



LINKER OPTIONS 

As with the Assembler-16 , you can specify the one letter 
options in one of four ways : 

option switches the option ON 

option =Y switches the option ON 

option =N switches the option OFF 

option = drive switches the option ON using 

the specified drive number 
(for the M and options only) 

The options and their defaults are: 



L (Create Map File) 

Creates a file containing a Linker map on the drive 
specified. The Linker assigns this file the same filename 
as the source, with the extension /MAP. The default is M=N. 



(Output Program File) 

Creates a final, executable program file on the drive 
specified. The default is 0=Y. 



P (Print Linker Map on Printer) 

Prints the Linker map. The default is P=N. 
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T (Print Linker Map on Terminal) 

Prints the Linker on the video display terminal. The 
default is T=Y. 



EXAMPLE LINK 

This is an example of linking a control file named TEMP/CTL. 
The next section, "The Linker Map" will use it to 
demonstrate the the various maps the Linker outputs. 

TEMP/CTL (created with the Editor) contains these 
directives : 

*LINK OF TEMP/CTL 
INCLUDE TEMP /OBJ 
ORIGIN 0200 
INCLUDE TEMPB/OBJ 
ORIGIN 0500 
INCLUDE TEMPC/OBJ 
INCLUBE THREE/OBJ 
END 

Note: The word INCLUBE (in the next to the last line) is 
intentionally misspelled. The section on "The Linker Map" 
uses this misspelling to demonstrate how the Linker outputs 
errors . 

This command, typed at TRSDOS-16 Ready: 

LINK16 TEMP {L=2,P,T=N} <ENTER> 

causes the Linker to link an absolute program, following the 
directives in TEMP/CTL, and: 

. create a map file on drive 2 named TEMP /MAP (M=2) 
. print the map on the printer (P) 
. not print the map on the video terminal (T=N) 
. create a program file named TEMP (0=Y is the 
default ) 



THE LINKER MAP 

The Linker map consists of the following: 
1. linker control listing 
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2. allocation map 

3. definitions map 

4. undefined references map 

5 . summary 



1. Linker Control Listing 



The Linker outputs the linker control listing first. It 
contains each directive from the control filespec 
interspersed with error messages. 

The above example produces the following listing: 

00001 * LINK OF TEMP/CTL 

00002 INCLUDE TEMP/OBJ 

00003 ORIGIN 0200 

00004 INCLUDE TEMPB/OBJ 

00005 ORIGIN 0500 

00006 INCLUDE TEMPC/OBJ 

00007 INCLUBE THREE/OBJ 
***** $ _ ILLEGAL COMMAND 

00008 END 

***** WARNING - UNRESOLVED EXTERNAL REFERENCE AT J2(j2fJ?5J2f2 

The Linker prints error messages as it encounters them. 
There are three classes : 

ERRORS — these are caused either by syntax errors 
in the control file or object code errors. (The 
above example has an ILLEGAL COMMAND error due to 
the misspelling of INCLUBE.) 

WARNINGS — these are to advise you that the Linker 
might be interpreting your file in a different way 
than you intended. (The warning in the above example 
is due to an undefined symbol, MYSTERY SYMBOLIC 
LABEL, which appears in the undefined references map.) 

FATAL — these are caused by errors in the object 
code construction. You should never get one of these 
errors when using the Assembler-16 . These errors will 
always cause the Linker to abort the linkage. Note 
that an error line may be printed immediately before 
the fatal diagnostic. 



Radio /hack 



66 



ASSEMBLER- 16 TRS-SQ ® THE LINKER 



Note that the above example lists the comment, *LINK OF 
TEMP/CTL. However, this comment has no effect on the 
linkage . 



2. Allocation Map 

The allocation map describes where in memory the Linker has 
located the INCLUDEd object files (modules). 

The above example produces this map: 

ALLOCATION MAP 

MODULE NO ORIGIN LENGTH DATE CREATOR VER 

TEMP 1A 000000 11/24/81 ASM-16 1.0 

TEMPB 2A 000200 11/24/81 ASM-16 1.J0 

TEMPC 3 000500 00000C 11/24/81 ASM-16 1.J0 

The meaning of each column is as follows: 

MODULE — the linked object filename. Only the filename 
(not the extension) is printed. 

NO — the sequential order in which the modules are 
INCLUDEd. If the module is part of an ASECT (an 
absolute program section), this number is followed 
by the letter A. 

ORIGIN — the memory address where the module is 
loaded . 

LENGTH — the length of the module. The characters 

• 1 i n this column indicate the module is part 

of an ASECT and therefore the length is undefined. 

DATE — the date the module was created. 

CREATOR — the name of the assembler or compiler 
used to create the module. 

VER — the version number of creator (1.0 for ASM-16). 

The above example indicates that the Linker included 
TEMP /OBJ, an absolute section, at address 0000. 



Radio /hack 



67 



ASSEMBLER-16 TRS-80 ® THE LINKER 



TEMPB/OBJ and TEMPC/OBJ, both relocatable, are included at 
hexadecimal 200 and 500. THREE/OBJ is not included, since 
the word INCLUBE was misspelled. 



3. Definition Map 

The definition map lists all the symbol defined as external 
by the DEF directive. 

The above example produces this map: 

DEFINITIONS 

SYMBOL VALUE PROG 

SYMBOLICLABEL J000052 1A 

The meaning of each column is as follows: 

SYMBOL — the symbol itself . A maximum of 45 characters 
are printed. (This example contains only one.) 

VALUE — the symbol ' s value 

PROG — the module which defined the symbol. If the 
number is part of an ASECT, the letter A follows it. 

The Linker does not sort this map. It prints the symbols in 
the same order it encounters them. 

The Linker will not print this listing if there are no 
externally DEFined symbols. 



4. Undefined Reference Map 

This is a listing of all symbols referenced, but not 
defined. 

The above example produces : 

UNDEFINED REFERENCES 

SYMBOL 
MYSTERYSYMBOLICLABEL 
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indicating the file references only one undefined symbol — 
MYSTERYSYMBOLICLABEL — which was what caused the warning in 
the directive listing. 

The Linker prints the symbols in the same order it 
encounters them. It does not print the map if there are no 
undefined symbols. 



5 . Summary 

This is the completion message, with a count of errors and 
warnings . 

The above example produces : 

RSECT LENGTH = 000000. 
PROGRAM ENTRY = 000000 
PROGRAM LENGTH = 0005 0C 
POS INDEPENDENT = NO 

LINK COMPLETE: 00001 ERRORS, 00001 WARNINGS. 

which shows that 000C is the length of TEMPC/OBJ, the one 
relocatable program section; 0000 is the originating address 
of the entire program; 050C is the length of the entire 
program; and the program is not position independent.. 

The Linker generated one error and one warning. 



ERROR MESSAGES 

This is a listing of the Linker error messages, divided into 
three groups : 

1 . ERRORS 

2 . WARNINGS 

3 . FATAL 



ERRORS 

These messages alert you that the program will not link 
properly. 

FILE UNAVAILABLE, CODE= error code 
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The file included in the control file cannot be accessed for 
the reason cited by the TRSDOS error code. 

For example : 

FILE UNAVAILABLE: 'filename', CODE = 24 
indicates TRSDOS error 24 (file not found). 

ILLEGAL COMMAND 

The directive is not one of those allowed by the Linker. 

SYNTAX ERROR 

The directive has not been typed correctively. 



WARNINGS 

These messages warn you that the Linker might be taking a 
different action than you intended. 

DOUBLE DEFINED RSECT 

The module has more than one RSECT (for example, a blank 
RSECT and a named RSECT). The Linker allows only one RSECT 
per module. 

DOUBLE DEFINED SYMBOL: 'symbol' 

The symbol enclosed in quotes is defined in two separate 
modules. The Linker uses the first definition it 
encounters . 

ERRORS GENERATED DURING ASSEMBLY 

There were errors generated during the assembly of the 

module . 

SIZE ERROR AT: absolute address 

An external will not fit into the field reserved. The 

Linker lists the absolute address of the modifiable part 

of the instruction generating the error. 

For example: 

SIZE ERROR AT: 000202 
might occur when address 200 of the module contains an 
instruction such as : 

LDW .DO, /external 

with the Linker evaluating 'external' as greater than H'FFFF 
(the maximum value that will fit into a word). 

To solve the problem, put a '.L' after the name of the 
external wherever it is referenced. For example: 
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LDW .DO, /external .L 
will never generate a SIZE ERROR. (However, it does cost an 
extra word of program storage over the previous example.) 

Note that the address associated with the size error does 
not indicate the address of the instruction. Instead, it 
indicates the address of the modifiable field (the address 
where the external will be loaded.) 

UNRESOLVED EXTERNAL REFERENCE AT: absolute address 
The Linker did not find a definition (DEF) for an external 
reference (REF). The Linker lists the absolute address of 
the instruction generating the error. 

WARNINGS GENERATED DURING ASSEMBLY 

There were warnings generated during the assembly of the 

current module. 



FATAL 

These errors should NEVER occur in normal use of the Linker. 
The Linker detects these errors primarily to support 
development of compilers and assemblers. 

If one of these errors occurs while using the Assembler-16 , 
it should be considered a BUG and be reported. See also the 
OBJECT CODE DESCRIPTION section in this manual. 

Note that unless otherwise stated, these errors are FATAL. 
The Linker will abort with an error message. 

DOUBLY DEFINED SECTION LENGTH 

The Linker encountered two DEFINE SECTION LENGTH plexes in 

the object stream. 

END OF OBJECT ENCOUNTERED 

The object code stream was improperly terminated (no END OF 
OBJECT plex). This may be caused by terminating the 
assembler (with BREAK key) before normal completion. 

ILLEGAL POLISH EXPRESSION 

An object code expression was encountered that does not 

conform to the standards set forth in the object code 

description. 

MODULE HAS MORE THAN ONE PROCESSOR DEFINED 

The DEFINE PROCESSOR plex was encountered more than once. 
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UNDEFINED EXTERNAL SYMBOL 

A SYMBOL REFERENCE was made without that symbol previously 

being defined. 

UNDEFINED OPERATOR 

An invalid operator was encountered during expression 

evaluation. 

UNDEFINED POLISH COMMAND 

An invalid operand was encountered in expression 

evaluation . 

UNDEFINED RSECT SELECTED 

An attempt was made to select a section (RSECT) that was not 

previusly defined (opened). 

RSECT LENGTH UNDEFINED 

A define section length plex was not encountered in the 
object stream. This is only a warning (the linker does 
not abort ) . 
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CHAPTER 5 
THE DEBUGGER 
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CHAPTER 5/ THE DEBOGGER 

The Model 16 Debugger (DEBUG) allows you to: 

. debug an existing 68000 machine code program 
. insert a 68000 machine code program into memory 

The way to start the Debugger depends on which you want to 
do . 

(DEBUG will not load if it is not included in a file named 
C0NFIG16/SYS. See Appendix D if it does not load properly.) 

STARTING THE DEBUGGER 

To Debug an Existing Program. . . 

To debug an existing program, type (at TRSDOS-16 Ready): 

DEBUG ON <ENTER> 

which turns ON a switch causing the Debugger to activate. 
While this switch is ON, any program you load is loaded into 
the Debugger. (The Debugger remains dormant until you load 
a program. ) 

For example, with the DEBUG ON, type: 

SAMPLE <ENTER> 

which loads SAMPLE into the Debugger. The Debugger displays 
the Register Display and a # prompt. 

The # prompt indicates you are in the Debugger command mode 
and can enter any of the Debugger commands . Type : 

H < ENTER > 

for a menu of all the commands . 

To turn OFF the Debugger switch, type (at the Debugger # 
prompt ) : 

<ENTER> 
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or (at the TRSDOS-16 Ready prompt): 
DEBUG OFF < ENTER > 

To Insert a New Program. . . 

To insert a new machine-code program with the Debugger, type 
(at TRSDOS-16 Ready): 

DEBUG <ENTER> 

which causes the Debugger to activate, displaying the 
Register Display and the # command prompt. 

To insert a program beginning at address 5000, type: 

C 5000 <ENTER> 

the Debugger displays address 5000 (in parentheses and its 
contents. To enter the MOVW instruction, type: 

30BC < ENTER > 

and the Debugger inserts 30BC, the operation word for this 
instruction, and waits for you to insert the next 
instruction. (See Chapter 8, "Instructions", for 
information on machine code operation words.) 

Type Q <ENTER> to return to the # prompt. Type Q <ENTER> 
again to exit the Debugger. 



REGISTER DISPLAY 

When you first start-up the Debugger, the Register Display 
appears on your screen. Certain Debugger commands will 
"call" it (cause it to appear again) or update it. 

This is an example Register Display: 

TRS-80 Model 16 DEBUG Version 3 . J0 

PC=000000R X=0 N=0 Z=0 V=0 C=0 IM=0 S=U w _ 

A=008018FE 00800A40 00801B4E 00801B6A 00000000 008014EE 00801886 00802000 

D 000000E8 00000000 0000FFFF 00000000 00000000 00000000 00000000 00000000 
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Line 1 contains the contents of the PC (program counter 
register and and the value of the condition codes. Notice 
that the PC register is set to a "relative" address. (The 
character R indicates the address is relative.) 

TRSDOS-16 loads DEBUG in memory that is "invisible" to the 
user. Therefore, a program origin address of zero is 
actually a "relative zero". All addresses are relative to 
the end of TRSDOS-16 and DEBUG. (See Appendix B, "Memory 
Map. ) 

Line 2 contains the contents of each of the eight address 
registers. (column 1 is register AJ0, column 2 is Al, etc.) 

Line 3 contains the contents of each of the eight data 
registers . 

(The Debugger uses the same register notations as the 
Assembler-16. See Section II for a listing of these 
notations . ) 

You can display or change the contents of any of the 
registers. To do this, type the name of the register 
preceded by a period ( . ) . 

For example, at the # prompt, type: 

.A0 <ENTER> 

and the Debugger displays the contents of register AJ0. 
If you do not wish to change this, simply press <ENTER>. If 
you do wish to change it, type the new value and then press 
< ENTER >. 



DEBUGGER COMMANDS 

To execute a Debugger command, type the one-letter command 
followed by <ENTER>. 

Some of the commands allow you to specify parameters. You 
must type a blank space between the command and the 
parameter . 

The parameters you can specify are: 

. value 
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. register (register direct) 
. address 



Specifying a value 

To specify a value , you can use: 

. a number 

(must be hexadecimal) 
. an ASCII character 

(must be enclosed in quotes) 

or an expression of values separated by these operators: 

. addition (+) 
. subtraction (-) 

For example, when using the Change command, it prompts you 
for a value . You could enter: 

2121 <ENTER> 
to insert the hexadecimal value of 2121, 

'AB' < ENTER > 
to insert the ASCII codes for 'A 1 and 'B 1 , or 

32+ 'A 1 <ENTER> 
to insert 32 plus the ASCII code for 'A 1 . 

Specifying a register directly 

To specify a register directly, precede the register name 
with the character §. This indicates direct register 
addressing. (This is the opposite of the Assembler-16 ' s use 
of the @ notation.) 

For example: 

D @A1 <ENTER> 

displays the contents of register Al. (If Al contains 1111, 
the Debugger displays 1111.) 
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Specifying an address 

To specify an address , you can use: 

. a value 

(as defined above) 
. a indirect register, preceded by a period (.) 

(the Debugger interprets the period as indirect 
addressing. ) 

For example : 

D 1000 < ENTER > 
displays the contents of address 1000. 

D .Al <ENTER> 

displays the contents of the address contained in register 
Al. (If Al contains 1111, the Debugger displays the 
contents of address 1111.) 

D 1000+50 

displays the contents of address 1050. 

When you specify an address, the Debugger assumes you mean 
an address relative to base zero. You can change this 
assumption by changing the value of the displacement 
register (with the R command), and then specifying the 
address with the letter 'R 1 . 

For example, if you set the displacement register to a 
relative 2000: 

D 1000R 

displays the contents of address 3000. The Debugger 
computes this address as the sum of 1000 and 2000, the 
contents of the displacement register. 

D 1000+50R 

displays the contents of address 3050. 



The Debugger commands are : 
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A (Address Stop Command) 



A addressl , address2 ,mask 
A addressl , register , mask 

Executes the program being debugged until the contents of 
address2 or register is changed. 

You can specify the size of address2 or register with: 
/B (byte) 
/W (word) 
/L (long word) 

addressl is optional. If specified, execution begins at 
addressl . Otherwise, execution begins at the current 
address . 

mask is also optional. It allows you to mask address2 
or register . 

Examples : 

A ,§A5 

executes the program from the current position until 
register A5 is changed. 

A ,§A5,FF00 

stops execution when the third and fourth bytes (specified 
by the mask) of register A5 is changed. 

A 500,1044/L 

executes the programming beginning at address 0500 until the 
long word at 1044 is altered. 



B (Breakpoint Command) 

B breakpoint , address 
B breakpoint 
B breakpoint / 

Allows you to: 



Radio /hack 



80 



ASSEMBLER-16 TRS-SO ® THE DEBUGGER 



. set up to eight breakpoint addresses 
. display the contents of a breakpoint 
. reset a breakpoint 

Be sure to set the breakpoint address at the beginning of an 
instruction — never in the middle of an instruction. 

For example : 

B 1,1000 <ENTER> 

sets 1000 as the first breakpoint address. When you execute 
your program (with the G command), it will stop executing 
when it reaches address 1000. 

B 1 <ENTER> 

displays breakpoint 1. You can enter a new value or simply 
press <ENTER>. (******** means the breakpoint is not set.) 
Both the relative and non-relative values are displayed. 

B 1/ <ENTER> 
resets breakpoint 1 (to 32 bit-1). 

B <ENTER> 
displays all the breakpoints currently set. 

C (Change Command) 

C address 

Enters the "change mode" displaying the contents of the 
specified address (in parenthesis), followed by its 
contents . 

Type value <ENTER> to insert a new value for that address, 
( value can be one to four bytes.) 

Type / <ENTER> to see the contents of that address again. 

Press <ENTER> to see the contents of the next address (the 
next memory word). 
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Press <CTRL> <9> <ENTER> to see the contents of the previous 
word (the previous memory word). 

Type Q <ENTER> to exit the "change mode". 

Example : 

C F06A 
displays the contents of address F06A. 

307A <ENTER> 
changes the contents of that address to 307A. 

/ <ENTER> 
displays the address with its new contents. 

<ENTER> 
displays the next address. 

<CTRL> <9> <ENTER> 
displays the previous address. 

Q <ENTER> 
exits the change mode. 

D (Display Command) 

D address or register , address or register , address or 
register 

calls the Register Display and displays the contents of up 
to three address or registers in the top right-hand corner. 

The Debugger will continually update this display as you 
debug the program. 
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Examples : 

D A40B, .A5, §A4 



displays the Register Display with the contents of address 
A4#B, the address specified by register A5 , and the contents 
of register A4. 

D @A2 <ENTER> 

displays the contents of register A2 . 

E (Erase Breakpoints Command) 

E 
Erases the breakpoints. 

G (Go Command) 

G address 

executes the program beginning at the specified address . 
Execution continues until the Debugger reaches a breakpoint 
(set with the B command) or the end of the program. 

address is optional. If omitted, execution begins at the 
current address. 

Example : 

G 402B <ENTER> 

executes the program being debugged at address 0402B and 
continues until the Debugger encounters a breakpoint or the 
end of the program. 

H (Help Command) 

H 
Displays all the Debugger commands. 
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N (Next Instruction Command) 

N 

executes the next instruction and then calls the Register 
Display. 

After entering the N command, simply press <ENTER> to 
execute another "next" instruction. Executing any other 
command exits this "next instruction execution mode". 

If the next instruction is a call to a subroutine, the 
Debugger executes the entire subroutine. (Use the S command 
to single step through the subroutine.) 

Example: 

N 

executes the next instruction in the program currently being 
debugged . 

(Quit Debug with DEBUG OFF Command) 


Turns DEBUG OFF and exits the Debugger. The next program 
will load into the normal TRSDOS-16 Ready. 



Q (Quit Debug with DEBUG ON Command) 

Q 

Exits the Debugger leaving DEBUG ON. The next program will 
load into the Debugger. 

R (Relative Addressing Command) 
R value 

displays and changes (if you specify value ) or displays 
and allows you to change (if you omit value ) the contents 
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of the displacement register. At start-up, the value of 
the displacement register is zero. 

The R command helps in debugging relocatable program 
sections. By specifying an address as Relative, the 
Debugger will add to this address the value of the 
displacement register. 

Examples : 

R < ENTER > 

displays the value in the displacement register. Press 
<ENTER> to leave it unchanged. Enter a new value to 
change it . For example : 

1000 < ENTER > 

causes hexadecimal 1000 to be the new value of the 
displacement register. If you specify a relative address, 
such as : 

G 2000R < ENTER > 

the Debugger will interpret this as: 

2000 + 1000 (the value in the displacement register) 

causing the Debugger to begin program execution at address 
3000. 

R 3333 <ENTER> 

causes hexadecimal 3333 to be the new value in the displacement 
register . 



S (Step Command) 

S 

executes the next instruction and calls the Register Display, 

The S command is the same as N, except S will single step 
through a subroutine. 
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As with the N command, press <ENTER> to execute the next 
instruction. To exit the "single stepping mode", enter a new 
command . 

Example : 

S < ENTER > 

executes the next instruction in the program being debugged. 

V (View Command) 

V addressl, value 

V addressl, address2 

displays the contents of the addresses beginning with 
addressl (or the current address) and continuing for the 
number of bytes specified by value . 

If the value is larger than addressl , the Debugger 
interprets it as address2 . In this case it displays the 
address beginning with addressl and ending with 
address2 . 

If you specify only addressl , the Debugger displays 16 
bytes beginning with addressl . 

Examples : 

V 5000,100 <ENTER> 

displays 100 bytes of memory starting at address 5000. 

V 5000,5500 

displays memory starting at address 5000 through address 
5500. 

V 5000 <ENTER> 

displays 16 bytes of memory starting at address 5000. 

V < ENTER > 

displays the next 16 bytes of memory. 
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V .AJ0 

displays 16 bytes of memory starting with the address 
specified by the contents of register AJ0. 
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The Assembler-16 contains an easy-to-use set of assembly- 
language mnemonics for developing Motorola MC68000 programs 
on the TRS-80 Model 16. 

Please note that the Assembler-16 mnemonics are not the same 
as the Motorola mnemonics. This is due to a major effort 
among programming and engineering organizations to 
standardize mnemonics. 

Since the Assembler-16 mnemonics and notations are different 
from Motorola's, you will need to use this Reference Guide 
to learn the Assembler-16 ones. 

However, you will probably find it helpful to use these 
books to understand the logic of the 68000 Microprocessor: 



MC68000: 16-BIT MICROPROCESSOR User's Manual, 

Motorola Incorporated, 1980 

The 68000: Principles and Programming, by Leo J, 
Scanlon: Howard W. Sams & Co. , Inc., 
Indianapolis, Indiana, 1981. 
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KEY TO NOTATION 

The following notation conventions are used in this 
section: 

[ ] - the item within is optional. 

B - a byte length string (8 bits). 

W - a word length string (16 bits). 

L - a long word length string (32 bits). 

U - an undefined length string. 

exp - an expression (described in chapter 2). 

b - in place of a blank space. 

The registers are represented as follows: 

Ad or Dd - an address or data register used as a 

destination operand. 

An - one of the eight address registers AJ0-A7 (n 

specifies the register number). 

As or Ds - an address or data register used as a source 
operand. 

Au or Du - an address or data register used as an 
upper-bounds operand. 

Dn - one of the eight data registers D0-D7 (n 
specifies the register number). 

Rn - any data or address register (n specifies the 
register number). 

Ri - any register used as indexed register with 

optional .W (word) or .L (long) length 
specified. 

Ri - can be either An.W, An.L, Dn.W, or Dn.L. 
SP - the stack pointer. 

SSP - the supervisor stack pointer register ( SP in 
System Mode) . 

USP - the user stack pointer register (SP in the 
User Mode) . 
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CHAPTER 6 
68000 ORGANIZATION 
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CHAPTER 6/ 68000 ORGANIZATION 



The 68000 contains eighteen registers: eight data 
registers, eight address registers, a program counter, and a 
status register. Both address and data registers can be 
used for word and long word arithmetic operations as well as 
for indexing. In addition, address registers can be used 
for indirect addressing; and data registers can be used for 
byte arithmetic operations. 

Data registers are 32 bits in size. Byte operands occupy 
the low order 8 bits, word operations the low order 16 bits, 
and long word operands the entire 32 bits. The least 
significant bit is always labeled as zero. 

When one of the low order portions of a data register is 
used, only that low order portion is changed. The remaining 
high order position is not used or changed. 

Address registers are also 32 bits in size. However, they 
do not support byte-sized operands. Depending on the 
operation, either the low order 16 bits (word) or all 32 
bits (long word) are used. When the address register is a 
destination operand, the entire register is affected. In 
word size operations, the operands are sign extended to 32 
bits before the operation is performed. 

The user stack pointer (USP) is another 32 bit register. 
While you are in the user mode, it provides the stack 
address in specific stack operations such as PUSHA and LINK. 
While in the supervisor mode, you can use it as an operand. 

The system stack pointer (SSP), also 32 bits, serves as 
the stack register while you are in the supervisor mode. 
While in the supervisor mode, you can use USP as an operand. 
You can never use SSP as an operand, nor can you use USP as 
an operand while in the user mode. 

Note: TRSDOS-16 does not allow you to get into the 
supervisor mode. 

Another 32 bit register is the program counter. It 
contains the memory address of the next sequential 
instruction to be executed. 
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The status register is a 16 bit register which contains 
certain system information as is illustrated below: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



T| |S| III |X|N| Z I VlcT 



In this diagram: 

T - contains the status of the trace mode (set when 
trace is on, cleared otherwise). 

S - reflects the current status of the CPU (set in 
supervisor mode; cleared in user mode). 

I - contains the level of interrupt recognized by the 
CPU. 

Bits 8 through F make up the system byte of the status 
register. You can change these bytes only from the 
supervisor mode. 

The least significant byte (bits zero through seven) of the 
status register is known as the "user byte" or the 
"condition code register" (CCR). You can address this 
byte from either the user or supervisor mode. The CCR 
contains information pertaining to the actions of the 
current instruction. The bits in the CCR are: 

X - The extend bit is set when an instruction (like 
ADD) causes a carry at the most significant bit. 

N - The Negative bit is set when an operation 

results in a negative number (i.e., the most 
significant bit of the operand is set in an 
arithmetic operation). 

Z - The Zero bit is set when an operation results in 
a zero value. 

V - The overflow bit is set when an operation causes 
overflow of the operand (i.e., the resulting 
number is too big for the size of the operand. 

C - The Carry bit is set when an instruction (like 

ADD) causes a carry at the most significant bit. 
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Note: The carry and extend bits are set together during 
most operations. 
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MEMORY ORGANIZATION 



With the 68000 processor, data can be accessed by using byte 
(8 bits), word (16 bits), or long word (32 bits) operations. 
All words and long words begin on even-numbered addresses. 

The most significant byte is stored first and the least 
significant byte is stored last: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 

word 000000 
byte 000000 | byte 000001 



word 000002 
byte 000002 J byte 000003 



word FFFFFfi 
byte FFFFFE | byte FFFFFF 



Long Word/Register/Address Organization - 32 Bits (MSB and 
LSB signify the most and least significant bits, 
respectively) : 



long word 1 



long word 2 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 
MSB high order 
long word 



low order 



LSB 



high order 
low order 



Decimal Data - 2 binary coded decimal digits equals 1 byte 
(MSD and LSD signify the most and least significant bits, 
respectively) : 
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15 14 13 12 


11 10 9 


8 


7 


6 5 4 


3 2 1 





(MSD) 
BCD 


(LSD) 
BCD 1 


BCD 2 


BCD 3 


BCD 4 


BCD 5 


BCD 6 


BCD 7 
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INSTRUCTION FORMAT 



When the Assembler-16 translates the 68000 instructions into 
machine code, it arranges them so that the instruction word 
(16 bits) comes first, followed by any operands, which may 
include up to four more words. The result of this operation 
is stored in the destination. The source is the second 
operand. This is illustrated below: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 


1 


operation word 
(first word specs operation & mode) 


immediate operand 
(if any, one or two words) 


source mode register extension 
(if any, one or two words) 


destination mode register extension 
(if any, one or two words) 



The typical format of the operation word follows, where mode 
and register are three bit fields. 
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15 14 13 12 11 10 







X 



X 



mode 



reg, 
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ADDRESSING MODES 



The 68000 allows you to address data seven different ways: 



1. Implicit - The operand is implied from the 
instruction . 

2. Register Direct - The operand or operands are in a 
data and/or address register. 

3. Address Register Indirect - The operand is in a 
memory location pointed to by an address register. 

4. Indirect with Indexing - The operand is in a memory 
location which is pointed to by the sum of an address 
register and an index register. 

5. Memory Direct (or Absolute) - The operand is in a 
memory location which is supplied by an expression. 

6. Program Relative - The operand is in a memory 
location which is offset from the PC by a given 
displacement . 

7. Immediate - The operand follows the instruction word. 
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Implicit Addressing 

Some instructions make implicit reference to the program 
counter (PC), the system stack pointer ( SP ) , the supervisor 
stack pointer (SSP), the user stack pointer (USP), or the 
status register (SR). The table below provides a list of 
these instructions and the registers implied. 



INSTRUCTION 


IMPLIED REGISTER(S) 


branch conditional (Bcc), branch (BR) 


PC 


break (BRK) 


SSP SR 


break on overflow (BRKV) 


SSP SR 


call to subroutine (CALL) 


PC SP 


check register against bounds (CHK) 


SSP SR 


test condition decrement and branch (DBcc) 


PC 


signed divide (DIV) 


SSP SR 


unsigned divide (DIVU) 


SSP SR 


link and allocate (LINK) 


SP 


move condition codes (MOVE CCR) 


SR 


move status register (MOVE SR) 


SR 


move user stack pointer (MOVE USP) 


USP 


push effective address (PUSHA) 


SP 


return from exception (RETI) 


PC SSP SR 


return and restore condition codes (RTR) 


PC SP SR 


return from subroutine (RET) 


PC SP 


unlink (UNLK) 


SP 



Radio /hack 

103 



ASSEMBLER-16 68000 ORGANIZATION 

TRS-80 ® 



Register Direct Modes 

The operand is in one of the 68000 registers. So, it could 
be in either A0-A7 , D0-D7 , CCR, SR, or USP (USP can only be 
used in the supervisor mode). 



Data Register Direct: .Dn 

The operand is in the specified data register. For example, 

CLRW . D0 
clears the least significant word in data register DO. 



The operand is a data register; length (1) is 1, 2, or 4 
bytes . 

31 



OPERAND (Dn) 



Address Register Direct: .An 

The operand is in the specified address register. For 
example, 

MOVL .A0, .Al 

moves the long word contents of address register A0 to 
address register Al. 



The operand is an address register; length (1) is 2 or 4 
bytes (this addressing mode is valid for word and long 
operations only). 
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31 







OPERAND (An) 
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Memory Address Modes 

The operand is a memory location pointed to by the specific 
mode. 



Address Register Indirect: @An 

The operand is in a memory location pointed to by an address 
register. The addressing mode is used to address data. 

For example : 

CRLB §AJ0 

clears the byte at the memory location referenced by address 
register A0. 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 



31 







ADDRESS REGISTER (An) 


t 


r 


MEMORY 


T 


r 


OPERAND 



'^\ 



Address Register Indirect Postincrement: @An+ 

The operand is a memory location pointed to by the contents 
of an address register (A0-A7). 
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When the operation is complete, the address register is 
incremented by one, two, or four. The increment size 
depends on whether the size of the operand is byte, word, or 
long word. If the address register is the stack pointer (SP 
or A7) and the operand is one byte, the address is 
incremented by two rather than one to keep the stack pointer 
on a word boundary. This addressing mode causes data mode 
memory accesses . 



For example: 
CLRW 



@A0+ 



clears the word at the memory location referenced by address 
register A0 and then increments A0 by 2. 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 



31 







ADDRESS REGISTER (An) 



OPERAND LENGTH 



> 



< 



v 



MEMORY 



OPERAND 



Address Register Indirect Predecrement: -§An 
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The operand is in a memory location pointed to by the 
contents of an address register (A0-A7). 

Before the operand location is used it is decremented one, 
two, or four. The decrement size depends on whether the 
operand is size is byte, word, or long word. If the address 
register is the stack pointer and the operand size is byte, 
the address is decremented by two rather than by one to keep 
the stack pointer on a word boundary. This addressing mode 
causes data mode memory accesses. 



For example, 
CLRL 



-§A0 



Decrements address register A0 by 4 and then clears the long 
word at the memory location referenced by A0 . 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 



31 







ADDRESS REGISTER (An) 



OPERAND LENGTH 



> 




MEMORY 



T 



OPERAND 
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Address Register Indirect 

with 16-bit Displacement: /exp§An 

The operand is a memory location pointed to by the contents 
of an address register plus a 16 bit expression which is 
sign extended to 32 bits by the processor. This addressing 
mode causes data made memory addresses. By branch 
instruction, it can refer to program locations. 

For example, 

CLR 8@A0 

clears the word at the memory location given by the sum of 
address register A0 and 8. 

The operand is a memory location; length is (1) = 1, 2, or 4 
bytes 



31 







ADDRESS REGISTER (An) 



T 



31 16 15 

SIGN 
EXTENSION 







EXPRESSION > 



J 



MEMORY 



OPERAND 
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Address Register Indirect Indexed 

with 8-bit Displacement: /exp§An(Ri) 

The operand is a memory location determined by the sum of 
the contents of the specified address register, an index 
register (either a double word or a sign-extended word) and 
the 8-bit expression which is sign extended to 32-bits by 
the processor. This mode causes data mode memory accesses, 
except when used with the BR and CALL instructions. 

For example , 

CLRW 5§A0(D0) 

clears the word at the memory location given by a sum of 
five, address register A0, and index register D0. 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 
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31 







MEMORY ADDRESS (An) 



T 



31 



8 7 









SIGN 
EXTENSION 




EXPRESSION 


31 





LONG INDEX REGISTER 


31 


OR 
16 15 


SIGN 
EXTENSION 


WORD 
INDEX 
REGISTER 




MEMORY 



OPERAND 
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Special Address Modes 

The operand is a memory location pointed to by an 
expression. 



Short Absolute: /exp [ .W] 

The operand is a memory location pointed to by a 16 bit 
expression which is sign-extended to 32 bits by the 
processor. This addressing mode causes data mode memory 
accesses. With branch instructions, it can be used to 
reference program locations. 



For example , 
CLRW 



/SUM.W 



clears the word at the memory location given by SUM (the 
address of SUM has been assigned by a directive such as RES 
or DATA). 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 



31 16 15 

SIGN 
EXTENSION 







EXPRESSION 



MEMORY 



OPERAND 



Long Absolute: /exp[.L] 
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The operand is in a memory location pointed to by a 32 bit 
expression. The first word of the expression the high order 
part of the address. The second word of the expression is 
the low order part of the address. This addressing mode can 
be used to address data. With branch instructions it can be 
used to reference program locations. 

For example, 

CLRW /HEADING. L 

clears the word at the memory location given by HEADING (the 
address of HEADING has been assigned by a directive such as 
RES or DATA) . 

The operand is in a memory location; length is 1, 2, or 4. 
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15 







FIRST 
EXPRESSION 



15 







SECOND 
EXPRESSION 



31 



16 15 







CONCATENATION 
OF TWO WORDS 



MEMORY 



OPERAND 



Program Relative: exp@PC 

The operand is in a memory location pointed to by the sum of 
the program counter (PC) and a sign extended 16 bit 
expression. The value of the program counter is the 
address of the 16 bit displacement. This addressing mode 
causes program mode memory accesses. With the branch 
instruction it can be used to refer to program locations. 

For example , 



BR 



LOOP 
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branches to memory location LOOP. Note that the "@PC" is 
optional here. 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 



31 



PROGRAM COUNTER 



T 



31 16 15 

SIGN 
EXTENSION 







EXPRESSION 



> 



T 



MEMORY 







OPERAND 



Program Relative with Index: exp§PC(Ri) 

The operand is in a memory location pointed to by the sum of 
the program counter, the index register (Ri) and the 8-bit 
expression. Both the index register and the expression are 
sign-extended to 32 bits by the processor. The value in the 
program counter is the address of the displacement value. 
This addressing mode causes program mode memory references. 



For example, 
CLRW 



NUM@PC(D1) 
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clears the word at the memory location given by the sum of 
NUM, the PC, and data register Dl. 

The operand is in a memory location; length is 1, 2, or 4 
bytes . 



31 











PROGRAM COUNTER 


31 


8 7 





SIGN 
EXTENSION 


EXPRESSION 




+ 




31 







LONG INDEX REGISTER 




V 




+ 




31 


01 
16 15 St 






SIGN 
EXTENSION 


WORD 
INDEX 
REGISTER 














^ 


r 








MEMORY 




■< 


' 






OPERAND 



Immediate Data: #exp[ .W] #exp[.L] 
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The operand follows the instruction word in either one or 
two extension words, depending on the size of the operation: 

Byte Operation - The operand is the low order byte of 

the first extension word. 

Word Operation - The operand is the extension word. 

Long Operation - The operand is in the two extension words. 

The high order 16 bits are in the first 
extension word; the low order 16 bits are 
in the second extension word. 

For example, 

LDW .D0,#H'112F 

loads the data register D0 with the immediate data H'112F. 

The operand is in the memory location immediately following 
the instruction; length is 1 or 2 bytes for 1 extension word 
and 4 bytes for 2 extension words. 
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31 



PROGRAM COUNTER 



CONSTANT (2) 



> 



+ 



< 







MEMORY 



OPERAND 



Radio /hack 



118 



ASSEMBLER-16 ASSEMBLER-16 PROGRAM 

TRS-SO ® 



CHAPTER 7 
THE ASSEMBLER-16 PROGRAM 



Radio /hack 



119 



ASSEMBLER-16 ASSEMBLER-16 PROGRAM 

TRS-SO ® 



CHAPTER 7/ THE ASSEMBLER 16 PROGRAM 

An assembly language source program can contain: 

- Labels 

- Instructions, Directives, or Programmed Operations 

- Operands 

- Comments 

These are organized into a program line in one of the 
following ways: 

[ label ] bb [ INSTRUCTION ] bb [ operand ( s ) [ 1 ] ] bb [ comment ] , 

[ label ] bb [ DIRECTIVE ] bb [ operand ( s ) [ 1 ] ] bb [ comment ] or 

[ label ]bb[ PROGRAMMED OPERATION] bb[ operand (s ) [ 1 ]] bb [ comment ] 



All fields are described as optional. A statement will have 
at least one field. Others will be optional depending on 
the statement. 



LABELS 

A label statement begins in column 1. It can be either 
global or local. A label must be followed by at least two 
spaces . 

Global - 

If the label is global (accessible by any main programs or 
subroutines), it can contain up to 45 characters. The first 
character must be alphabetic, the next 45 nonblank 
characters can be alphabetic, numeric, or an underline. No 
more than one consecutive blank space is permitted in a 
symbol. Single blanks are not significant. Two global 
labels which match the first 45 nonblank characters are the 
same to the Assembler-16 . 

A global label can be the only entry on a source input line 
(this is known as a "hanging label"). Any reference to a 
hanging label will, in effect, be a reference to the 
statement following the hanging label. 
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Local - 

If the label is a local label (defined only within the 
current program), it is defined on the current location 
counter. Local labels consist of a dollar-sign character 
($) followed by a single integer. Local labels are used in 
the same way global labels are except that the scope is 
delimited by global labels. 



INSTRUCTIONS 

There are three types of instructions you can use: 

- Mnemonics 

- Directives 

- Programed Operations 

Mnemonics 

The instruction (mnemonic) field can begin anywhere except 
in column one. If there is a label, two blanks must 
separate the label and instruction. The mnemonic field 
contains one of the allowed M68000 operation mnemonics, 
followed by an operand length (1) indicator where needed. 

Length - 

With most instructions, you may specify the length of the 
operand on which it will act. This length (1) can be: 

B - byte (8 bits) 

W - word (16 bits) 

L - long word (32 bits) 

For example : 

ADDB 

signifies an ADD instruction of one byte (8 bits). 

If you do not specify a length, the Assembler-16 assumes a 
length. If the Assembler-16 cannot determine the length, it 
assumes word length and issues a warning to that effect. 

The following table illustrates the length assumed by the 
Assembler-16 : 
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First Operand: 



Second 
Operand: 



B 
W 
L 
U 



B 



W 



u 



B 


B 


B 


B 


B 


W 


w 


W 


B 


W 


L 


L 


B 


w 


L 


U 



You cannot specify length on unsized instructions or on 
instructions with only one size possibility. 



Directives 

The same basics that apply the instructions, apply to 
directives : 

The label if present, begins in column one with two 
blanks separating it from the directive. If there is 
no label, the directive can begin in column two. Some 
directives require either a label in the statement or 
a hanging label preceding the statement. 

The operand field syntax depends on the directive. The 
field begins two or more blank spaces beyond the end of 
the directive field. The field is terminated by two 
consecutive blanks not inside a quoted string. 

The optional comments* field is two blank spaces after 
the operand field. If there is no operand, it begins 
two positions after the directives field. 



Programed Operations 

The format for programmed operations is similar to that of 
directives : 

The programmed operation field contains a predefined 
program operator. It is defined in a user-defined 
opcode directive statement (in the source program) 
prior to its use as an opcode. This is done with the 
FORM directive (see Chapter 9). 

The operands are likewise predefined. 
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The label, if any, is defined at the current location 
counter. 



OPERANDS 

The optional operand field is separated from the mnemonic 
field by at least two blank spaces. The format of the 
operands depends upon the instruction; 0, 1, 2, or more 
operands may be permitted. In certain addressing modes an 
operand length (1) can be optionally stipulated: 

.W = word 

.L = long word 



General Operand Rules: 

1. Multiple operands are separated by a comma. 

2. Operands are checked by the Assembler-16 both by number 
and by addressing modes. 

3. Each operand must be valid for the instruction being 
performed. 

4. Single blank spaces are permitted within symbols and 
around operators and special characters. 

5. Two or more blank spaces terminate the operand field 
and begin the comment field unless the blank spaces are 
within a quoted string. 



COMMENTS 

The optional comment field is separated from the previous 
field by at least two blanks. You cannot have a comment 
with a hanging label, nor may you have a comment on an END 
statement which does not have an entry point specified. A 
comment can occupy a whole line if there is an asterisk (*) 
in column one. 
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EXPRESSIONS 



Expressions occur as operands of machine instruction, 
assembler directive statements, or as programmed operation 
statements. An expression consists of one or more terms 
separated by optional operators. 

Each term in an expression may be: 

a self -defining constant, 

a symbol (local or global), 

the program location counter character (*), or 

a parenthesized expression. 

Constants may be decimal, hexadecimal, binary, octal, or 
character constants: 

Hexadecimal constants consist of a string of hex digits 
preceded by capital H quote (H 1 ). 

Binary constants consist of a string of binary digits 
preceded by capital B quote (B'). 

Octal constants consist of a string of octal digits 
preceded by capital Q quote (Q 1 ). 

A Character constant is a single character preceded by 
a quote (single or double). Packed character constants 
are not allowed. 

A local or global symbol represents an address. The 
Assembler-16 uses the symbol as a displacement to the PC 
register . 

The program counter (PC) results in a 32 bit displacement 
of the current statement. 

Expression evaluation is left to right with unary operator 
precedence. Parentheses may be used to change the order of 
expression evaluation. The operators used to build an 
expression are arithmetic or logical. 

Arithmetic operators act upon 32 bit signed integer 
quantities with negative numbers in twos complement format. 

+ is addition 
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is unary minus or subtraction 
* is multiplication 
/ is signed division 

Only addition and subtraction are permitted using 
relocatable values. 

Logical operators act upon 32 bit binary unsigned numbers. 

.AND. is logical AND 

.XOR. is logical XOR 

.OR. is logical OR 

.NOT. is logical NOT 

.SHL. is shift left logical 

where 

A.SHL.B 

shifts value A left B bits if B is positive and shifts value 
A right (-B) bits if B is negative. 

The Assembler-16 computes the size attribute of an 
expression from the size attribute of the terms of the 
expression. If exactly one term has a non-U size attribute, 
and all other terms have a U size attribute, then the 
expression inherits the non-U size attribute. If more than 
one term has a non-U size attribute, or if all terms have a 
U size attribute, then the expression is assigned a size 
attribute of U. 
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CHAPTER 8/ INSTRUCTIONS 



Description 



In this chapter, each instruction is listed alphabetically, 
They are either listed individually or as part of an 
instruction group. 



Instruction Groups 

Some of the instructions fall into an instruction group. 
Each instruction within the group uses the same mnemonic, 
but the assembler-16 translates them into different machine 
codes. Preceding each instruction group is an overview 
giving the general function of the instruction group. 



Individual Instructions 

Some instructions have only one form. The function of 
individual instructions follows its syntax. 



Syntax 

The syntax consists of the mnemonic, the sizes allowed, and 
the addressing modes permitted. For example: 

LDA .Ad,/exp[.W or .L] Operand length(l) = L 
.Ad,[exp]@As[ (Ri) ] 
.Ad,exp[@PC[ (Ri) ] ] 

The operand length is long (L); hence the mnemonic is LDA. 
The destination operand is an address register ( .Ad) , and 
the source operand may be either : 

1. an absolute short or long address ( "/exp[ .W or 
.L]" ) 

2. an indirectly derived address with optional 
displacement and index ( " [ exp] @As[ (Ri ) ] " ) 

3. a program relative address with optional index 
( "exp[@PC[ (Ri) ]]" ) 
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Condition Codes 

After execution of the instruction, the status of the 
condition codes may change. This change is reflected under 
"Condition Codes". Each bit of the condition code register 
(CCR) may be listed as: 

the bit is unaffected by the instruction 
the bit is cleared (reset to 0) after the 

instruction is executed 
* the bit is either set to 1 or reset to based on 

the result of the operation 
U the bit is undefined for the operation 



For example: 



X N 



V C 



_ * 







This means that the X bit is not affected, the N and Z bits 
are set or cleared based on the result of the operation, and 
the V and C bits are always cleared. 



Instruction Fields 

The Assembler-16 translates the instruction into machine 
code. This machine code is referred to as the "Instruction 
Field". For example: 



15 14 13 12 11 10 9 8 







10 



size 



mode 







reg. 



This is the instruction code for CLeaR. The top line refers 
to the bit number in the instruction word and the numbers in 
the second line refer to the actual bit. In this example, 
bits 8-15 contain the machine code for the CLeaR 
instruction. 

The word "size" is listed under bits 6-7. This refers to 
the size of the operand to be CLeaRed (i.e., byte, word, or 
long word). Under bits 3-5 is the word "mode". This refers 
to the addressing mode (e.g. direct address register, short 
address, etc.) The addressing mode takes three bits to 
describe, and these codes are listed on the next few pages. 
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Under bits 0-2 is the word "register". This refers to the 
register number used by the instruction. This value also 
requires three bits and the codes for each register are 
listed on the following pages. For example, the 
instruction: 

CLRL . Dl 

generates the following code: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 








1 














1 





1 




















1 



(Note: The instruction codes may vary from the example 
above, depending on the number of operands, the sizes 
allowed, etc . ) 



REGISTER/MODE CODES 

Function 
Code 

Data Register Direct 

Address Register 

Address Register Indirect 

Address Register Indirect 
Postincrement 

Address Register Indirect 
Predecrement 

Address Register Indirect 
16-bit displacement 

Address Register Indirect 

Indexed with 8 bit displacement. 

This mode requires an additional one word extension: 

15 14 13 12 11 10 9 8 7 6 



Reg . /mode 
Mnemonic 


Mode Code 


= .Dn 


000 


= .An 


001 


= §An 


010 


= @An+ 


011 


= -@An 


100 


= exp@An 


101 


= exp@An(Ri) 


110 



Reg. 

n 
n 
n 
n 

n 

n 







D/A 



reg. | W/L 1 01 0| 01 displacement value 
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Bit 15 - 

= data register is index register 

1 = address register is index register 

Bits 14 through 12 - 

index register number 

Bit 11- 

= sign extended, low order integer in index 

register 

1 = long value in index register 



Absolute Short Address 

Absolute Long Address 

Program Relative 

Program Relative with 
Index 

This address mode requires one word of extension: 

15 1 14 13 12 11 10 9 8 7 6 5 4 3 2 10 



= /exp[ .W] 


111 


000 


= /exp[ .L] 


111 


001 


= exp §PC 


111 


010 


= exp §PC(Ri) 


111 


JZfll 



D/A | register |W/L| \ \ \ displacement value 



Bit 15 - 

= data register 

1 = address register 

Bits 14 through 12 - 

index register number 

Bit 11 - Index size 

= sign extended, low order word in index 

register. 

1 = long value in Index Register. 



Immediate Short 




= #exp[ .W] 


111 


100 


Immediate Long 




= #exp[ .L] 


111 


100 


Status Register 




= .SR 


111 


100 


Condition Code Regis 


ter 


= .CCR 


111 


100 
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ADD 
ADD binary 



This instruction's general operation is: 

ADD[1] destination, source 

which adds the source to the destination, 
stored in the destination. 



The result is 



The Assembler-16 can interpret the binary ADD four different 
ways. From the operands used, it determines which 
instruction is to be executed. 

The Assembler-16 chooses which operation to use according to 
the following guidelines: 



ADD quick 

ADD address 

ADD immediate 
ADD data register 



if the source is immediate 
(indicated by the # sign) and less 
than or equal to 8 . 

if the destination is an address 
register and the source is other 
than immediate. 

if the source is immediate and 
greater than 8 (more than 3 bits). 

for any other operations performed 
by the ADD instruction. A data 
register is always one of the 
operands . 
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ADD 
ADD quick/ ADD immediate 



ADD[1] .Dd, #exp[.w or .L] Operand length(l): B W L 

-§Ad, #exp[.W or .L] 

@Ad+, #exp[.W or .L] 

/explE.Wor .L], #exp2[.Wor .L] 

[expl]@Ax[ (Ri)], #exp2[.Wor .L] 

.Ad, #exp[.W or .L] (Quick only (1)=W L only) 



Condition Codes: 

X N Z V C 



X - Set if carry occurred, cleared otherwise (same as 

carry (C) ) . 
N - Set if result is negative, cleared otherwise. 
Z - Set if result is zero, cleared otherwise. 
V - Set if overflow generated, cleared otherwise. 
C - Set if carry occurred, cleared otherwise. 

Condition codes are not affected if an addition to an 
address register is made. 



Examples : 

If D0 is H'8J02A, then 

ADDW .D0,#H'7000 
changes the contents of D0 to H'F02A 
If D0 contains H'002A, then 

ADDW .D0,#4 
Changes the contents of D0 to H'002E. 

Instruction Fields for ADD quick 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



10 11 data | |size| mode | reg. | 
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The data field contains bit data, with values 1-8. 
(001-111 = 1-7 decimal 000 = 8 decimal) 

The size field contains the size of the operation. 

If the size field contains 00 it is a byte operation. 
If the size field contains 01 it is a word operation. 
If the size field contains 10 it is a long word 
operation. 

The mode and register fields contain the address mode 
of the destination operand. Address register direct 
addressing is not permitted when the size of the instruction 
is byte length. If the size is word length and the 
destination is an address register, the source is sign 
extended to 32-bits. 



Instruction Fields for ADD immediate 

According to the size of the operation, the number of 
extensions for the immediate data vary (see data fields) 



15 14 13 


12 


11 10 


9876543210 


1 





1 


1 |size mode reg. 


+ 


byte data (8 bits) | 


or 


word data 


(16 


bits) 




or 


long word 


(32 


bits inc 


luding previous word) 



The size field contains the size of the operation. 

If the size field contains 00 it is a byte operation, 
If the size field contains 01 it is a word operation 
If the size field contains 10 it is a long word 
operation. 

The mode and register fields contain the address mode 
of destination operand. 

The data field contains the data immediately following 
the instruction: 
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If the size field contains 00, then the data is in the 

low order byte of the immediate word (8 bits). 

If the size field contains 01 , then the data is in the 

entire immediate word (16 bits). 

If the size field contains 10, then the data is in the 

next two immediate words (32 bits). 
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ADD 
ADD address register 



ADD[1] .Ad, .As Operand Length(l) :W,L 

. Ad , . Ds 

.Ad, -@As 

.Ad, §As+ 

.Ad, /exp[ .W or .L] 

.Ad, [exp]@Ay[ (Ri)] 

.Ad, exp[@PC[(Ri)]] 

.Ad, #exp[.W or .L] (Add immediate only) 

Adds the source to the destination address register. 



Example : 

If AJZf contains H'60J2f0 and Al contains H* 0010 , then 

ADDW .AJ3,.A1 

changes the contents of AJ0 to H * 6010 . 

Condition Codes: 

X N Z V C 



All of the flags are unaffected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 



1 1 1 register! size 



mode 



reg. | 



The register field contains any address register; always 
the destination operand. 

The size field contains the size of the operand. 

If the size field contains 001 it is a word operation, 
The source operand is sign-extended (See EXT) to fill 
32 bits of the address register. 
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If the size field contains 111 it is a long word 
operation. 

The mode and register fields contain the address mode 
of the source operand. 



/~*\ 
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ADD 
ADD data register 



Operand length(l):B,W,L 
ADD[1] .Dd, .Ds 
.Dd, -@As 
.Dd, @As+ 

. Dd , /exp [ . W or . L ] 
.Dd, [exp]@Ay[(Ri)l 
.Dd, exp[@PC[(Ri)]] 

.Dd, .As (Word and long word length only) 
-@Ad, .Ds 
@Ad+ , . Ds 

/expt.W or .L],.Ds 
[exp]@Ax[ (Ri)],.Ds 

A data register is always one of the operands. 



Example : 

If DjZf contains H'j2fl43 and Dl contains H ' 0001 , then 

ADDW . DjZf , . Dl 
changes the contents of D0 to H'014A. 

Condition Codes: 

X N Z V C 



X - Set if carry occurred, cleared otherwise (same as 

carry (C) ) . 
N - Set if the result is negative, cleared otherwise, 
Z - Set if the result is zero, cleared otherwise. 
V - Set if overflow is generated, cleared otherwise. 
C - Set if carry occurred, cleared otherwise. 



Instruction Fields: 



15 14 13 12 11 10 



3 2 10 



1 1 1 | register | size/op] mode 
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The register field contains the data register. 

The size/op field contains the size of the operation and 
the destination of the result. 

B Y te Word Long Word Destina tion 
000 001 010 data register 

100 101 110 second operand 

The mode and register fields contain the location of 
the second operand. 

If the second operand is the source operand and its 
size is one byte, the address register direct 
addressing mode is not permitted. 
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ADDC 
ADD binary with Carry 

ADDC[1] .Dd,.Ds Operand length (1): B,W,L 

-@Ad, -@As 

Adds the source and carry bit at the destination. The 
result is stored in the destination. 



Example : 

If D0 contains H'05 and Dl contains H'06, and the extend bit 
of the status register is set, then 

ADDCB . D0 , . Dl 

changes the contents of DJ3 to H'J2(C. 

Condition Codes: 

X N Z V C 



X - Set if carry is generated, cleared otherwise. 

N - Set if the result is negative, cleared otherwise. 

Z - Cleared if the result is nonzero, unchanged otherwise, 

V - Set if overflow is generated, cleared otherwise. 

C - Set if carry is generated, cleared otherwise. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 1 reg(d) 1 size J3|r/m| reg(s) 



The register (d) field contains the destination register 

If the R/M field is zero, register(d) is the data 
register . 

If the R/M field is one, register (d) is the address 
register in the predecrement addressing mode. 

If the size field contains 01 it is a word operation. 
If the size field contains 10 it is a long operation. 
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The R/M fiel| contains the operand addressing mode. 

If the R/M fxeld is 0, the operation is from data 
register to data register. 

memorv ^ ^^ iS lf th& °P eratio " is from memory to 



memory , 



The register (s) field contains the source register 
If the R/M field is 0, register (s) is the data 
register. 

If the R/M field is 1, register (s) is the address 
register in predecrement addressing mode. 



/~\ 
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ADDD 
ADD Decimal (BCD) with extend 



ADDD .Dd, .Ds 

-@Ad, -@As 



Operand length ( 1 ) : B 



Adds the source and the extend bit to the destination and 
then stores it in the destination. Binary coded decimal 
arithmetic is used for the addition. 



Example : 

If D0 contains 6 and Dl contains 7, and the extend bit of 
the status register is set, then 

ADDD .D0,.D1 

changes the contents of D0 to 14. 

Condition Codes: 

X N Z V C 



U 



U 



X - Set if a carry (BCD) is generated, cleared otherwise. 

N - Undefined. 

Z - Cleared if the result is non-zero. Unchanged otherwise, 

U - Undefined. 

C - Set if a carry (decimal) generated. Cleared otherwise. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 I 1 I I I reg(d) |1 \0 \0 \0 |J0|R/M| reg(s)l 



If the R/M field is , the operation is from data register 

to data register. 

If the R/M field is 1, the operation is from memory to 

memory. 

The register (s ) field contains the source register. 
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The reqister(d) field contains the destination register, 
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AND 
logical AND 



The AND instruction can be interpreted by the Assembler-16 
two different ways. From the operands used, the 
Assembler-16 determines which instruction to use. 

AND[1] destination, source 

which ANDs the source with the destination. The result is 
stored in the destination. 



The Assembler-16 chooses which operation to use according to 
the following guidelines: 

AND immediate if the source is immediate 

(indicated by the # sign). 

AND data for any other operations 

performed by the AND 
instruction. A data register 
is always one of the operands. 



Condition Codes: (Identical for both operations) 
X N Z V C 



_ * 







X - Not affected 

N - Set if the most significant bit of the result is set, 

cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Always cleared. 
C - Always cleared. 
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AND 
logical AND immediate 



AND[1] 



.Dd, #exp[.Wor .L] Operand length(l): B,W,L 



-§Ax, #exp[.W or .L] 

@Ax+, #exp[.W or .L] 

/explf.W or .L], #exp2[.Wor .L] 

[expl]@Ax[(Ri)J, #exp2[.Wor .L] 

.CCR, #exp[.Wor .L] (1=W only) 



Example : 

If D0 contains H'4F, then 

ANDB .Dj2f,#H'Fje( 
changes the contents of D0 to H'40. 



Instruction Fields: 

15 14 13 12 11 10 9 8 
I 1 W 



size 



mode 



1 



reg. 



or 



word (16 bits ) 



or 



byte data (8 bits) 



long word (32 bits) 



The size field contains the size of the operation. 

If the size field contains 00 it is a byte operation, 
If the size field contains 01 it is a word operation. 
If the size field contains 10 it is a long word 
operation. 

The register and mode fields contain the address mode 
of the destination operand 

The data field contains the data immediately following 
the instruction: 
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If the size field contains 00, the data is in the low 

order byte of the immediate word ( 8 bits ) . 

If the size field contains 01, the data is the entire 

immediate word (16 bits). 

If the size field contains 10, the data is the next two 

immediate words (32 bits). 
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AND 
logical AND data 



AND[1] .Dd, .Ds 
.Dd, -§Ay 
.Dd, @Ay+ 

.Dd, /exp[.W or .L] 
.Dd, [exp]@Ay[ (Ri)] 
.Dd, exp[@PC[(Ri)]] 
-@An, .Ds 
@Ax+,.Ds 

/exp[ .W or .L] , .Ds 
[exp]@Ax[ (Ri)],.Ds 



Operand length(l) :B,W,L 



Example : 

If D0 contains H'FFj30 FF00 and Dl contains H'00FF J2T0FF , then 

ANDL . DO , . Dl 
changes the contents of D0 to E' 0000 0000. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 I register | size/op | mode | reg, 

The register field contains the data register. 

The size/op field contains the size of the operation and 
the destination of the result: 



Byte 
000 
100 



Word 
001 
101 



Long Word 
010 
110 



Destination 
data register 
second operand 



The register and mode fields contain the location of 
the second operand. 
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Bcc 
Branch on condition 



Bcc[l] exp[@PC] Operand length(l): B,W 

Tests a condition. If the condition is true, sets the 
program counter (PC) to the value of the operand. If the 
condition is false, program execution continues at the next 
instruction . 



Example : 

If the zero flag of the status register is set, and LOOP is 
a statement label somewhere in the program, then, 

BE LOOP 

transfers control of the program to the instruction at LOOP, 

Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



\ condition [ 8 bit displacement 



16 bit displacement (if 8 bit dislacement is 0) 



The £ bit displacement field contains the two's 
complement integer which contains the relative distance (in 
bytes) between the current instruction address, plus 2, and 
the referenced instruction. 

The _16 bit displacement field allows larger 

displacement than 8-bits. It is used if the 8-bit field is 

equal to zero. 

The condition field is one of the following fourteen 
conditions : 
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0111 BE - equal 
0110 BNE - not equal 
0101 BC - carry 

0100 BNC - no carry 

1010 BP - positive 

1011 BN - negative 
1001 BV - overflow 
1000 BNV - no overflow 

1110 BGT - greater than 

1100 BGE - greater than or equal 

1101 BLT - less than 

1111 BLE - less than or equal 

0010 BH - higher than 

0011 BNH - not higher than 

0101 BLO - low 

0100 BHS - high, same 
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BR 
BRanch control addressing 

BR /exp Operand length(l): unsized 

[exp]@Ax[(Ri)] 
exp[@PC(Ri)] 

The program execution branches to the address given by the 
operand. 

Example : 

If LOOP is a statement label somewhere in the program, then 

BR LOOP 
transfers control of the program to the instruction at LOOP 

Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 11J011| mode 1 reg 



The register and mode fields contain the address of 
the next instruction. 
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BRK 
BReaK 



BRK #exp Operand length(l): Unsized 

Three operations are performed by this instruction: 

1. The program counter is pushed into the supervisor 
stack. 

2. The status register is pushed into the supervisor 
stack. 

3. The vector number (#exp) is loaded into the program 
counter . 

This instruction initiates exception processing. The vector 
number is generated to reference the Break exception vector 
which is specified by the four low order bits of the 
instruction. Sixteen vectors are available. 

Example : 

If a supervisory call (SVC) has been set up, then 

BRK #0 
causes execution of that SVC. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 



15 14 13 12 11 10 9 8 















1 



#exp 



The #exp field contains the number (break vector) to be 
loaded into the program counter. 
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BRKV 
BReaK on overflow 



BRKV Operand length(l): Unsized 

Initiates exception processing if the overflow condition is 
on (overflow(V) = 1). Generates the vector number to 
reference the overflow exception vector as follows: 

Program Counter (PC) — > Stack 
Status Register (SR) — > Stack 
Overflow Vector — > Program Counter (PC) 

No operation is performed if the overflow is off. Execution 
continues with the next instruction. (Note: You must set 
the overflow vector using the SETTRP SVC before executing 
the exception . ) 



Example : 

If the overflow bit of the status register is set, then 

BRKV 
initiates overflow exception processing. 

Condition Codes : 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 





1 


1 








1 


1 


1 








1 


1 


1 





1 


1 


0\ 
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a 



CALL 
CALL general 

CALL /exp Operand length(l): Unsized 

[exp]@Ax[ (Ri)] 
exp[@PC(Ri)] 



Example : 

If SUB1 is the label of a subroutine somewhere in the 
program, then 

CALL SUB1 

transfers control of the program to the instruction at SUBl, 

Condition Codes: 

X N Z V C 



None of the flags are affected. 
Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 4 3 


2 1 








1 








1 


1 


1 





1 





mode 


reg. 





The register and mode fields contain the address of 
the next instruction. 
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CHK 
CHecK against bounds 



CHK 



. Du , . Dn 

-@Au, .Dn 

@Au+ , . Dn 

/exp [ . W or . L ] , . Dn 

[exp] @Ax[(Ri)], .Dn 

exp[@PC[(Ri)]], .Dn 

#exp[ .W or .L] , Dn 



Operand Sizes : W 



Examines 
(Dn) and 
bound is a 
is initiated 
greater than 



the content of the low order in the data register 
compares it to the upper bound operand. The upper 
two's complement integer. Exception processing 
if the data register is less than zero or 
the upper bound operand. Generates the vector 



number to reference the CHK instruction exception vector, 
(Note: You must set the CHK vector with the SETTRP SVC 
before executing this statement.) 



Example : 

If D0 contains H*0100 and Dl contains H'0101, then 

CHK .D0,.D1 
initiates CHK exception processing. 



Condition Codes: 



X N Z V 



X 

N 

Z 
V 

c 



- * u u u 



Not affected. 

Set if Dn is less than zero; cleared if Dn is greater 

than the; undefined otherwise. 

Undefined. 

Undefined . 

Undefined. 



Instruction Fields: 
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15 14 13 12 11 ljg 9 8 7 6 5 4 3 2 1 
1 J0 I data reg.|l 1 | mode ~ 



reg. 



(upper bound) 

The data register contains the data register whose 
content is checked. 

The register and mode fields contain the upper bound 
operand word. 
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CLR 
CLeaR an operand 



CLR[1] .Dn 
-@An 
§An+ 

/exp[ .W or .L] 
[exp]@An[(Ri)] 



Clears the operand to all zero bits. 

Example : 

If DJZf contains H ' 0001 , then 

CLRW . DJZf 

changes the contents of DJZf to H ' 00 . 

Condition Codes: 

X N Z V C 



Operand length(l): B,W f L 





- 1 1 


X 


= Not affected. 


N 


= Always cleared. 


Z 


= Always set . 


V 


= Always cleared. 


C 


= Always cleared. 



Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 6 


5 4 3 


2 1 








1 














1 





size 


mode 


reg. 



The register and mode fields contain the operand 
addressing mode. 

The size field contains the size of the operation: 

If the size field contains 00 it is a byte operation, 
If the size field contains JZfl it is a word operation, 
If the size field contains 10 it is a long word 
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operation. 

CMP 
CoMPare 

This instruction's general operation is: 
CMP[1] Destination, Source 

where the source is subtracted from the destination and the 
condition codes (CCR) are set according to the results. The 
values of the operands are not changed. 

The compare instruction is interpreted by the Assembler-16 
as four different instructions. The Assembler-16 determines 
which is to be executed by the operands. 

The Assembler-16 chooses which operation to use according to 
the following guidelines: 

CMP immediate if the source is immediate 

(indicated by the # sign). 

CMP memory if both operands are addressed 

with the postincrement 
addressing mode. 

CMP address for any other compare 

operation where 
the destination is addressed 
using the address register 
direct mode. 

CMP data for any other compare 

operation where the 
destination is addressed using 
the data register direct mode. 

Condition Codes: are identical for all CMP operations. 
X N Z V C 



_ * 



X - Not affected. 

N - Set if the result is negative, cleared otherwise, 

Z - Set if th eresult is zero, cleared otherwise. 
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V - Set if overflow is generated, cleared otherwise. 
C - Set if borrow is generated, cleared otherwise. 
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CMP 
CoMPare immediate 



CMP[1] 



.Dd, #exp[.W or .L] 

-@Ax, #exp[.W or .L] 

§Ax+, #exp[.w or .L] 

/expl[.w or .L], #exp2t.W or .L] 

[expl]§Ax[(Ri)], #exp2[.W or .L] 



Operand length(l): B,W,L 



Example 

If D0 contains H'0010, then 

CMPW .D0,#H*10r 
sets the zero bit of the status register. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



I 



1 1 | size | mode 

+ 



r eg. I 



or 



byte data (8 bits) 



word data (16 bits) 



or 



long word data (32 bits, including previous word) 



The size field contains the size of the operation. 

If the size field is 00, it is a byte operation. 

If the size field is 01, it is a word operation. 

If the size field is 10, it is a long word operation. 

The register and mode fields contain the address mode 
of the destination operand. 

The data field contains the data immediately following 
the operation word. 

If the size field is 00, the data is low order byte of 

the immediate word (8 bits). 

If the size field is 01, the data is the entire 



S~\ 
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immediate word (16 bits). 

If the size field is 10, the data is the next two 

immediate words (32 bits). 
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CMP 
CoMPare memory 



CMP[1] @Ad+, @As+ 



Operand length(l): B,W,L 



Example : 

If A0 points to memory address H • 4000 , which contains H'j2f0, 
and Al points to address H*4004, which contains H * 05 then 



CMPB 



@AJ0+,@A1+ 



sets the negative and carry bits of the status register and 
increments AJ0 and Al by 1. 



Instruction Fields: 

15 14 13 12 11 10 







9 8 



1 



1 1 I reg.(d) | 1 jsizel 1 |reg.(s)| 



The register(d) field contains the destination register. 

The register (s) field contains the source register. 

The size field contains the size of the operation. 

If the size field is 00, it is a byte operation. 
If the size field is 01, it is a word operation. 
If the size field is 10, it is a long word operation 
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CMP 
CoMPare address 



CMPtl] .Ad, .As 

. Ad , . Ds 

.Ad, -@As 

.Ad, @As+ 

.Ad, /exp[ .w or .L] 

.Ad, [exp]§Ay[ (Ri)] 

.Ad, exp[@PC[(Ri)]] 

.Ad, #exp 



Operand length(l): W, L 



Example : 

If K0 contains H'000F F000 and Al contains H'000F 0000, then 

CMPL .AJ0,.A1 
clears the negative bit in the status register. 



Instruction Fields: 

15 14 13 12 11 10 







reg, 



size 



mode 







reg, 



The register field contains the destination address 
register . 

The size field contains the the size of the operation 
If the size field is 001 , it is a word operation. 
The source is sign extended to a long operand and the 
operation is performed internally using all 32 bits. 
If the size field is 011, it is a long word operation, 

The register and mode fields contain the source 
address mode. 
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CMP 
CoMPare data 



CMP 
CMP[1] 



Operand Length(l): B,W,L 



. Dd , . Ds 

.Dd f -@As 

.Dd, @As+ 

.Dd, /exp [ .W or .L] 

.Dd, [exp]@Ay[(Ri)] 

.Dd, exp[@PC[(Ri)]] 

.Dd, As ([1]=W, L only) 



Instruction Fields: 



15 14 13 12 11 10 9 8 







reg. 



size 



mode 



reg. 







The register field contains the destination data 
register . 

The size field contains the size of the operation. 

If the size field is 000, it is a byte operation. 
If the size field is 001 , it is a word operation. 
If the size field is 010, it is a long word operation, 

The register and mode fields contain the source 
operand addressing mode. 



s~\ 
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DBcc 
test condition Decrement and Branch 



DBcc .Dx, exp[@PC] Operand length(l): W 

A condition is tested. If the condition is determined to be 
true, no operation is performed. If the condition is false 
(not cc), the low order word (16 bits) of the data register 
is decremented. When false and the result is -1, then no 
other operation is performed (the program goes to the 
next instruction); if the result is anything besides -1, 
then the program counter is set to the value of the second 
operand (PC plus exp, where PC is the address of exp, the 
displacement word). 



Examples : 

If D0 contains H'02, the zero bit in the status register is 
set, and LOOP is a statement label, then 

DBNE .D0,LOOP 

changes the contents of D0 to H'01, and then transfers 
control of the program to the instruction at LOOP. 

If DjZf contains H'0F1, the zero bit in the status register is 
clear, and LOOP is a statement label, then 

DBNE .D0,LOOP 

transfers control to the next sequential instruction (D0 is 
not decremented). 



If D0 contains E' 00 , the zero bit in the status register is 
set, and LOOP is a statement label, then 

DBNE . DJ0,LOOP 

transfers control to the next sequential instruction (D0 is 
decremented to -1). 



Condition Codes: 
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N 



V 



None of the flags are affected. 



Instruction Fields: 

This instruction requires one word of extension for 
displacement [exp]. 



15 


14 


13 


12 


11 10 9 8 7 6 


5 


4 


3 


2 10 





1 





1 


condition 1 1 








1 


reg. 


displacement 



The condition field contains one of 16 conditions 
The cc mnemonic can be one of the following: 
Op Code - Mnemonic - Description 



0000 
0111 
0110 
0101 
0100 
1010 
1011 
1001 
1000 
1110 
1100 
1101 
1111 
0010 
0011 
0001 
0101 
0100 



DBR 

DBE 

DBNE 

DBC 

DBNC 

DBP 

DBN 

DBV 

DBNV 

DBGT 

DBGE 

DBLT 

DBLE 

DBH 

DBNH 

DEC 

DBLO 

DBHS 



always 

equal 

not equal 

carry 

no carry 

positive 

negative 

overflow 

no overflow 

greater than 

greater than or equal 

less than 

less than or equal 

higher than 

not higher than 

never 

low 

high, or same 



The register field contains the data register which is 
used as a counter. 

The displacement field contains the 16 bit displacement 
(exp) and specifies the distance of the branch. 
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DIV 
Divide signed 



Operand length(l): W 



DIV .Dd, -@As 

.Dd, @As+ 

. Dd , /exp [ . W or . L ] 

.Dd, [exp]@Ay[(Ri)] 

.Dd, exp[@PC[ (Ri)] ] 

.Dd, #exp[ .W or .L] 

. Dd , . Ds 

Divides the destination (always a data register) by the 
source and the result is stored in the destination. The 
destination is a long word (32 bits) and the source is a 
word (16 bits). The division is performed using signed 
arithmetic. The result is a long word (32 bits) where: 

1. The quotient is in the lower word. 

2. The remainder is in the upper word. 

3. The sign of the remainder is the same as the 
dividend unless the remainder is zero. 



Special Conditions: 

Division by zero causes a trap. 

Overflow may be detected and set before completion of the 
operation . 

If overflow occurs, the flag is set but the operands are 
unaffected. 

Example : 

If D0 contains H'0014 and Dl contains -6 (H'FFFA), then 

DIV . D0,.D1 

changes the contents of DjZf to H'j2l0j2f2 FFFD (-3 with a 
remainder of 2 ) . 
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Condition Codes: 



X N 



V 



X - 

N - 

Z - 

V - 

C - 



Not affected. 

Set if the quotient is negative, cleared otherwise, 

undefined if an overflow. 

Set if the quotient is zero, cleared otherwise, 

undefined if overflow. 

Set if overflow detected, cleared otherwise. 

Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 







reg, 



mode 



1 



reg, 



The register field contains the data (destination) 
register. 

The register and mode fields contain the source 
address mode. 



s~\ 
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DIVU 
Divide Unsigned 



Operand length(l): W 



DIVU .Dd, -@As 

.Dd, @As+ 

. Dd , /exp [ . W or . L ] 

.Dd, [exp]@Ay[ (Ri)] 

.Dd, exp[@PC[ (Ri)]] 

.Dd, #exp[ .W or .L] 

. Dd , . Ds 

Divides the destination (always a data register) by the 
source and stores the result in the destination. The 
destination is a long word (32 bits) and the source is a 
word (16 bits). The division is performed using unsigned 
arithmetic. The result is a long word (32 bits) where: 

1. The quotient is in the lower word. 

2. The remainder is in the upper word. 

Special Conditions: 

Division by zero causes a trap. 

Overflow may be detected and set before completion of the 
operation. 

If overflow occurs, the flag is set, but the operands are 
unaffected. 

Example : 

If D0 contains H'0014 and Dl contains R'0004, then 

DIVU .D0,.D1 
changes the content of DjZf to H ' 00 0005. 



Condition Codes: 



X N Z V C 



_ * * * * 
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X - Not affected. 

N - Set if the most significant bit of the quotient is set, 

cleared otherwise, undefined if an overflow. 
Z - Set if the quotient is zero, cleared otherwise, 

undefined if an overflow. 
V - Set if an overflow is detected, cleared otherwise. 
C - Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 \ reg. | 1 1 | modi" 



reg. 



The register fields contain the data (destination) 
register. 

The register and mode fields contain the source 
address mode. 
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EXT 
sign EXTended 



EXT[1] .Dn Operand length(l): W, L 

Sign-extends a byte to a word (bit 7 copied in bits 15-8), 
or a word to long word (bit 15 copied in bits 31-16). 

The operand is always a data register. 



Example : 

If D0 contains E' 0000 F00F, then 

EXTL . D0 

changes the contents of DJZf to H'FFFF F00F. 

Condition Code: 

X N Z V C 



_ * 







X - Not affected. 

N - Set if the result is negative, cleared otherwise, 

Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



10 10 1 size | I re"g 



The size field contains the size of the sign-extension. 
If the size field is 010, the sign extension is low 
order byte to word. 

If the size field is 011, the sign extension is low 
order word to long word. 

The register field contains the data register number 
(0-7) to be sign-extended. 
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LD 
LoaD data 



Can be interpretted by the Assembler-16 as four different 
instructions. By the operands used, the Assembler-16 
chooses which instruction to initiate. 

LD [1] destination, source 

where the destination is a register and the second operand 
is the data located at source. 



/^\ 
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LD 
LoaD condition codes 



LD[1] .CCR, #exp[.W] Operand length(l): W 

.CCR, -@As 

-CCR, @As+ 

.CCR, /exp[.W] 

.CCR, [exp]@As[ (Ri)] 

.CCR, exp[@PC[(Ri)]] 

. CCR , . Ds 

Loads the content of the source in the condition codes. The 
source is a word but only the low order 8 bits are loaded. 



Example : 

If the condition codes of the status register are all set, 
then 

LDW .CCR,#H'0E 

changes the codes so that the extend and carry bits are 
clear, and the negative, zero, and overflow bits are set. 



Condition Codes: 

X N Z V C 



***** 



Set all flags according to the source operand. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 J0 1 1 | mode | reg. 



The register and mode fields contain the addressing 
modes of the source. 
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LD 
LoaD data register 

LD[1] .Dd, -@As Operand length(l): B, W, L 

.Dd, @As+ 
.Dd f /expf.W or .L] 
.Dd, [exp]@As[ (Ri)] 
.Dd, exp[@PC[(Ri)]] 
.Dd, #exp[.W or .L] 
. Dd , . Ds 
.Dd, .As (1=W, L only) 

Loads the contents of the source into a destination data 
register. 



Example : 

If K0 points to memory address H'5000, which contains H'lF, 
and DJZf contains H 1 0000 0000, then 

LDB .D0,§AJ0+ 

changes the contents of Dj2f to K y 0000 001F, and increments A0 
by 1. 



Condition Codes: 

X N Z V 



_ * 



I 



X = Unaffected. 

N = Set if the result is negative, cleared otherwise, 

Z = Set if the result is zero, cleared otherwise. 

V = Always cleared. 

C = Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 







size 



destination 
reg. | mode 



source ^~ 
mode | reg. [ 



The size field contains the size loaded. 



^> 
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If the size field contains 01 the size loaded is byte. 
If the size field contains 11 the size loaded is word, 
If the size field contains 10 the size loaded is long, 



The destination fields determine the destination data 



register . 
order . 



Note that the register mode is reverse normal 



The source fields determine the source addressing mode. 
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LD 



LoaD address register 



Operand length(l): W, L 



LD[1] .Ad, #exp[W or .L] 

•Ad, -@As 

•Ad, @As+ 

•Ad, /exp[ .W or .L] 

•Ad, [exp]@As[(Ri)] 

.Ad, exp[@PC[(Ri)]] 

. Ad , .As 

. Ad , . Ds 

Loads the contents of the source to an address register. 

Example : 

If AJ0 contains H ' 00 00 0000, then 

LDW .AJ0,#H'FF00 

changes the contents of K0 to H'FFFF FFJ00 (the source is 
sign extended) . 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 

15 14 13 12 11 10 







8 



size 



destination 
reg. 10 1 



source 
mode | reg, 



The size field contains the size of the operand. 

If the size field contains 11, it is a word operation, 
The source is sign extended to a long operand and all 
32 bits are loaded into the address register. 
If the size field contains 10, it is a long operation, 
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The destination field contains the destination address 
register . 

The source field contains the addressing mode of the 
source. 
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LDA 
LoaD Address 



LDA .Ad, /expl.Wor .L] Operand length(l): L 

.Ad, [exp]@As[(Ri)] 
.Ad, exp[@PC[(Ri)]] 

Loads the specified address register with the address of the 
source. All 32 bits of the address register are affected. 

Example : 

If AJ0 contains H ' 0000 0000, Al contains H' 6000 and A2 
contains E' 0000 0025, then 

LDA .A0,H'10@Al(A2) 

Changes the contents of A0 to H' 000060035. 

Condition Codes: 

X N Z V C 



None of the flags are affected. 
Instruction Fields: 



15 


14 


13 


12 


11 10 


9 


8 


7 


6 


5 4 3 


2 10 


1 


1 








1 req. 




1 


1 


1 


mode 


reg. 1 



The register field determine the address register to 
load. 

The register and mode fields contain the address to be 
loaded. 
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LDM 
LoaD Multiple 

LDM[1] Rlist, @As+ Operand length(l): W, L 

Rlist, /exp 

Rlist, [exp]As([Ri) ] 

Rlist, exp[@PC[ (Ri)]] 

where R list is a set of registers (destination), separated 
by commas (Rx, Ry...etc). 

The registers in Rlist are loaded from consecutive memory 
locations beginning with the location specified by the 
source operand. The order of loading register is from D0 
to D7 , then from A0 to A7 . Note that this order is 
independent of the order given in Rlist (.Al,.D3, D2 would 
give the same result as . D2 , .D3, .Al.). If a word is 
stipulated in operand length (1), then the low order word of 
each register is loaded, and the word is sign extended into 
the upper word. 

If the source is the postincrement mode, the incremented 
address register is updated to contain the address of the 
last word loaded plus two. 



Example : 

If the memory addresses H' 6000-6003 contain H'AA AA BB BB, 
and D0 and Dl both contain H'0000 0000, then 

LDMW .D0,.D1,/H'6000 

changes the contents of D0 to H'0000 AAAA, and Dl to H'0000 
BBBB. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 
Instruction Fields: 
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A word extension Is added to the operation word for this 
instruction (Rlist). 



15 


14 


13 


12 


11 


10 


9 8 7 


6 5 4 3 


2 1 





1 








1 


1 


1 


sz mode 


reg. 


Rlist 





The size field contains the size of the operation. 
If the size field contains 0, it is word. 
If the size field contains 1, it is long. 

The register and mode fields contain the source 
addressing mode.0 

The Rlist field contains the registers in the Rlist as 
follows: 



15 


14 


13 


12 


11 


10 


9876543210 


A7 


A6 


A5 


A4 


A3 


A2 


Al A0 D7 D6 D5 D4 D3 D2 Dl D0 



This is where the bits corresponding to the registers 
included in the Rlist are set. 
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LDP 
LoaD Peripheral data 

LDPtl] .Dd, [exp]@As Operand length(l): W, L 

Loads the data into the data register (destination) from 
memory (source). The data in memory is formatted as one 
byte per word (the high order byte for even addresses and 
the low order byte for odd addresses). 



Example : 

If A0 contains H 1 6000 , addresses H 1 6000-6003 contain H ' FA 23 
IB 30, and D0 contains H'0000 0000, then 

LDPW .D0,@A0 

changes the contents of D0 to H'0000 FAlB. 
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OPERAND LENGTH: W 
MEMORY 



SOURCE ADDRESS TO DATA REGISTER 



A 


B 


C 


D 


E 


F 


G 


H 



EVEN — > 



ODD — > 



A C 



B D 



Example: 

If A0 contains H*6000, addresses H'6000 - 6001 contain H'FA 
23 IB 30 25 26 27 28, and D0 contains H 1 0000 0000 , then 

LDPL .D0,@a0 

changes D0 to H'FAlB 25 27 



OPERAND LENGTH: L 
MEMORY 



SOURCE ADDRESS TO DATA REGISTER 



A 


B 


C 


D 


E 


F 


G 


H 



EVEN — > 



ODD — > 



A C E G 



B D F H 



Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



\ data reg.|l \0 |sz|0 1 | add reg 



Cexp] 



The data register field contains the destination of 
the data register. 
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The size field contains the size of the operation. 

If the size field contains 0, the operation is word. 
If the size field contains 1, the operation is long. 

The address register field contains the source address 
register used in indirect mode (plus optional displacement) 

The [exp] field contains the placement used in 
calculating the operand address. 
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LINK 
LINK and allocate 

LINK .An, #exp Operand length(l): Unsized 

This is a three-step instruction: 

1. The address register specified (.An) is pushed 
onto the stack (.An occupied two words — 32 
bits ) . 

2. Then, the address register (.An) is loaded with 
the updated stack pointer. 

3. The sign-extended displacement (two's complement 
integer) is added to the stack pointer (#exp, 
occupies a 16-bit extension of the operation 
word) . 



Example : 

If A0 contains H'0011 4000, and the SP contains H'0000 3006, 
then 

LINK .A0, #H'100 

changes the contents of A0 to H'0000 3002, the SP to H'0000 
3002, and memory addresses H' 3002-3005 to H'00 11 40 00. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
A 1 1 110010101 reg. 

#exp 
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The register field contains the address register 
specified in the operand. 

The #exp field determines the two's complement integer 
which is to be added to the stack pointer. 
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MOV 
MOVe 



This instruction can be interpreted by the instruction four 
different ways. The operands used determine which 
instruction the Assembler-16 chooses. 



General Operation: 

M0V[1] destination, source 

where the operands are either both memory or both registers, 
The contents of the source is moved to the destination. 
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MOV 
MOVe address register 



M0V[1] .Ad, .As Operand length(l): W, L 

. Ad , . Ds 

The destination is an address register. 

Example : 

If Al contains H'FF00, and A0 contains H ' 000 0000, then 

MOVW.A0, .Al 

changes the contents of A0 to H'FFFF FF00 (the source is 
sign extended) . 

Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 



size 



destination 
register | 1 



source 
mode | reg , 



The size field contains the size of the operand. 

If the size field contains 11, it is a word operation, 
The source is sign extended to a long operand and all 
32 bits are loaded into the address register. 
If the size field contains 10, it is a long operation, 

The destination field determines the destination address 
register . 

The source field determines the addressing mode of the 
source operand. 
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MOV 
MOVe to condition codes 



M0V[1] .CCR, .Ds Operand length(l): W 

Loads the content of the source into the condition codes, 
Only the low order 8 bits of the source are loaded. The 
source is a word. 



Example : 

If D0 contains H'0011, and the condition codes are all 
clear, then 

MOV . CCR , . D0 

sets the extend and carry bits of the status register, and 
clears the negative, overflow, and zero bits. 



Condition Codes: 

X N Z V C 



All condition codes are set according to the source operand, 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



010 0100 I I - ] modi" 



reg. 



The register and mode fields contain the addressing 
mode of the source. 
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MOV 






MOVe general 




M0V[1] .Dd, 


.Ds Operand length(l): B, W f 


L 


.Dd, 


.As (1 = W or L only) 




-@Ax, 


-@Ay 




@Ax+, 


@Ay+ 




-@Ax, 


@Ay+ 




-@Ax, 


/exp 




-@Ax, 


[exp]@Ay[(Ri)] 




-§Ax, 


exp[@PC[ (Ri)]] 




§Ax+, 


-§Ay 




@Ax+, 


/exp 




@Ax+, 


[exp]@Ay[ (Ri)] 




§Ax+, 


exp[§PC[ (Ri)]] 




/exp, 


-@Ax 




/exp, 


@Ax+ 




/expl , 


/exp2 




/expl , 


[exp2]@Ax[ (Ri)] 




/expl , 


exp2[@PC[(Ri)]] 




[exp]@Ax[ (Ri)], ■ 


-@Ay 




[exp]@Ax[ (Ri)] f i 


§Ay+ 




[expl]§Ax[ (Ri)], 


/exp 2 




[expl]@Ax[(Ri)], 


[exp2]@Ay[ (Ri)] 




[expl]@Ax[ (Ri)], 


exp2[§PC[(Ri)]] 




-@Ax, 


#exp 




§Ax+ f 


#exp 




/expl , 


#exp2 




[expl]@Ax[(Ri)], 


#exp2 





Moves the contents of the source to the destination (memory 
to memory, or register to data register. 



Example 

If D0 contains H'1000 and Dl contains H'FF, then 

MOVB . D0 , . Dl 
changes the contents of DJ0 to H'lj2fFF 

Condition Codes: 
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X N 



V 



_ * 



I 



X = Unaffected. 

N = Set if result is negative, cleared otherwise. 

Z = Set if result is zero, cleared otherwise. 

V = Always cleared. 

C = Always cleared. 



Instruction Fields: 



/~> 
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15 14 13 12 11 10 



8 



1 



1 



size 



destination 
register | mode 



source 
mode | reg, 



The size field determines what size is moved. 
If the size field is 01 , it is byte. 
If the size field is 11, it is word. 
If the size field is 10, it is long. 

The destination fields contain the destination 
addressing mode (note reg. /mode is reverse normal order) 

The source fields contain the source addressing mode. 
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MOV 
MOV from SR 



MOV[l] .Dd, .SR Operand length(l): W 

Moves the contents of the status register to the data 
register. 



Example : 

If the SR contains H'8715 and D0 contains H ' 00 , then 

MOV . D0 , . SR 
changes the contents of D0 to H'8715. 

Condition Codes: 

X N Z V C 



None of the flags are affected. 



Instruction Fields: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
010000 01 n Siodi 



reg. 



The register and mode fields contain the destination 
data register. 
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MUL 
MULtiply signed 



Operand length(l): W 



MUL .Dd, -@As 

.Dd, §As+ 

.Dd, /exp t .W or .L] 

.Dd, exp]@Ay[ (Ri)] 

.Dd, exp[@PC[(Ri)]] 

.Dd, #exp[ .W or .L] 

. Dd , . Ds 

Multiplies the two signed word (16 bits) operands, producing 
a 32-bit signed result in the destination (data register). 
The register operands are taken from the low order word, 
leaving the high order word unused. All 32 bits of the 
product are saved in the destination. 

Example : 

If D0 contains H'0010 and Dl contains H'FFF5, then 

MUL . D0 , . Dl 
changes the contents of D0 to H'FFFF FF50. 
Condition Codes: 



X 

N 
Z 
V 
C 



X N 



V 



_ * 







Not affected. 

Set if the result is negative, cleared otherwise. 

Set if the result is zero, cleared otherwise. 

Always cleared. 

Always cleared. 



Instruction Fields: 

15 14 13 12 11 



10 



8 







I register |1 1 



mode 



reg, 



The register field contains the data register 
(destination ) . 
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The register and mode fields contain the source 
address mode. 
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MULU 
MULtiply Unsigned 



Operand length ( 1 ) : W 



MULU .Dd, -@As 

.Dd, @As+ 

. Dd , /exp [ . w or . L ] 

•Dd, texp]@Ay[(Ri)] 

.Dd, exp[@PC[ (Ri)]] 

.Dd, #exp[ .W or .L] 

.Dd, . Ds 

Multiplies two unsigned word (16 bits) operands, producing a 
32-bit unsigned result in the destination (data register). 
The register operands are taken from the low order word; the 
high order word is unused. All 32 bits of the product are 
saved in the destination. 



Example: 

If D0 contains H'001j0 and Dl contains H'0005, then 

MULU . D0 , . Dl 
changes the contents of DJ0 to H* 0000 0050. 

Condition Codes: 

X N Z V C 



_ * 



I 



X - Not affected. 

N - Set if the most significant bit of the result is set, 

cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Always cleared. 
C - Always cleared. 



Instruction Fields: 



15 


14 


13 


12 


11 10 9 


8 


7 


6 


5 4 3 


2 1 


1 


1 








T register 





1 


1 


mode 


reg. 1 
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The register field contains the data register 
(destination) . 

The register and mode fields contain the source 
address mode. 
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NEG 
NEGate 



NEG[1] .Dd Operand length(l): B, W, L 

-@Ad 
@Ad+ 

/exp [ . W or . L ] 
[exp]@Ax[ (Ri)] 

Subtracts the operand addressed as the destination from 
zero. The result is stored in the destination. 



Example : 

If D0 contains H'3A, then 

NEGB . D0 
changes the contents of D0 to H'C6. 



Condition Codes: 



N Z V 



X - 

N - 

Z - 

V - 

C - 



Set the same as carry ((c) - if borrow generated), 

cleared otherwise. 

Set if the result is negative, cleared otherwise. 

Set if the result is zero, cleared otherwise. 

Set if an overflow is generated, cleared otherwise. 

Set if a borrow is generated, cleared otherwise. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 



1000 100 I size mode reg. 



The size field contains the size of the operation, 
If the size field is 01, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long. 
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The register and mode fields contain the destination 
address mode. 
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NEGC 
NEGate with carry 



NEGC[1] .Dd 



Operand length(l): B, W, L 



-@Ad 

@Ad+ 

/exp [ . W or . L ] 

[exp]@Ax[(Ri)] 

Subtracts the operand addressed as the destination and the 
carry bit from zero. The result is stored in the 
destination. 



Example : 

If D0 contains H'34 and the extend bit of the status 
register is set, then 

NEGCB . D0 

changes the contents of D0 to H'CB. 



Condition Codes: 



N 



X - 

N - 

Z - 

V - 

C - 



Set the same as carry ((c) - if borrow generated), 
cleared otherwise. 

Set if the result is negative, cleared otherwise. 
Cleared if the result is nonzero, unchanged otherwise. 
Set if an overflow is generated, cleared otherwise. 
Set if a borrow is generated, cleared otherwise. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



01000000 size mode reg. 



The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01 , it is word. 
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If the size field is 10 it is long. 

The register and mode fields contain the destination address 
mode. 
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NEGD 
NEGate Decimal (BCD) with extend 



Operand sizes: B 



NEGD -@Ad 
@Ad+ 
/exp 

[exp]@Ax[(Ri)] 
.Dd 

Subtracts the operand and the extend bit from zero. Binary 
coded decimal arithmetic is used, storing the result in the 
operand address. The ten's complement of the destination 
is produced if the extend bit is clear, if the extend bit 
is set the nine's complement of the destination is produced, 
This is a byte only operation. 



Example : 

If D0 contains 51 and the extend bit of the status register 
is clear, then 

NEGD . D0 

changes the contents of D0 to 49. 

Condition Codes: 

X N Z V C 



u 



u 



X - Set if borrow (BCD) occurred, cleared otherwise (same as 

carry (c) ) . 
N - Undefined. 

Z - Cleared if the result is nonzero, unchanged otherwise. 
V - Undefined 
C - Set if borrow (BCD) occurred, cleared otherwise. (Same 

as extend (X) ) . 



Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 4 3 


2 10 





1 








1 

















mode 


reg. 
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The register and mode fields contain the operand 
destination (the address of the operand.) 
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NOP 
No Operation 



NOP Operand length(l): Unsized 

No operation occurs. The program counter is incremented by 
two. Otherwise, the processor state is unaffected. 



Example: 

If the PC contains H' 6000 , then 

NOP 
changes the PC to H/60J32. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 








1 








1 


1 


1 








1 


1 


1 











1 
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NOT 
logical NOT 



N0T(1) .Dd Operand length(l): B, W, L 

-@Ax 
@Ax+ 

/exp[ .W or .L] 
[exp]§Ax[ (Ri)] 

The one's complement of the operand is taken and is stored 
in the destination. 

Example 

If D0 contains H'3C, then 

NOTB . D0 
changes the contents of D0 to H'C3. 



Condition Codes: 



X 


N 


Z 


V 


C 


- 


* 


* 









X - Not affected. 

N - Set if the result is negative, cleared otherwise, 

Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Always cleared. 



Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 6 


5 4 3 


2 1 








1 











1 


1 





size 


mode 


reg. 



The size field contains the size of the oeration. 
If the size field is 00, it is byte. 
If the size field is 01 , it is word. 
If the size field is 10, it is long. 

The register and mode fields contain the destination 
address mode. 
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OR 
logical OR 



This instruction can be interpreted by the Assembler-16 two 
differnt ways. By the operands used, the Assembler-16 
chooses which instruction to execute. 



General Operation: 

0R[1] destination, source 

where the source is ORed to the destination and the result 
is stored in the destination. 

The Assembler-16 chooses which instruction to initiate by 
the following guidelines. 

OR immediate used if the source is 

immediate (indicated by a # 
sign) . 

OR data used for all other OR 

operations, one of the 
operands is always a data 
register . 

Condition Codes: (Identical for both operations) 
X N Z V C 



_ * 







X - Not affected. 

N - Set if the most significant bit of the result is set, 

cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Always cleared. 
C - Always cleared. 
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OR 
logical OR immediate 

0R[11 .Dd, #exp[.W or .L] Operand length(l): B, W, L 

-@Ax, iexpt.W or .L] 

§Ax+, #exp[.W or .L] 
/expl[.W or .L], #exp2[.W or .L] 
[expl]@Ax[(Ri)] f #exp2[.W or .L] 

.CCR, #exp[.W or .L] (1=W only) 

Example : 

If D0 contains H*C6, then 

ORB .Dj0, #H'2A 
Changes the contents of D0 to H'EE. 



Instruction Fields: 

15 14 13 12 11 



10 



10 



size 



mode 







reg, 



or 



byte data (8 bits) 



word data (16 bits) 



or 



long word data (32 bits including previous word) 



The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01 , it is word. 
If the size field is 10, it is long word. 

The register and mode fields contain the address mode 
of the destination operand. 

The data field contains the data immediately following 
the instruction: 

If the size field is 00, then the data is the low order 

byte of the immediate word (8 bits). 

If the size field is 01, then the data is the entire 
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immediate word (16 bits). 

If the size field is 10, then data is the next two 

immediate words (32 bits). 
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OR 
Logical OR data 



Operand length(l):B, W, L 



OR[l] .Dd, .Ds 
.Dd, -@Ay 
-@Ax , .Ds 
.Dd, @Ay+ 
@Ax+, .Ds 

.Dd, /exp[ .W or .L] 
/exp[.W or .L], .Ds 
.Dd, [exp]@Ay[(Ri) 
[exp]@Ax[ (Ri)], .Ds 
.Dd, exp[@PC[(Ri)]] 



Example: 

If D0 contains H'C6 and Dl contains H'2A, then 

ORB .D0, .Dl 
changes the contents of D0 to H'EE. 



Instruction Fields: 

15 14 13 12 11 10 







8 



reg, 



size/op | mode 



1 



reg , 



The register field contains the data register. 

The size/op field contains the size of the operation and 
the destination of the result: 



Byte 

000 
100 



Word 
001 
1J31 



Long Word 

010 
110 



Destination 
data register 
second operand 



The mode and register fields contain the location of 
the second operand. 



Radio /hack 

208 



ASSEMBLER-16 ^ INSTRUCTIONS 

TRS-80 ® 



PUSHA 
PUSH Address 



PUSHA /exp Operand length ( 1 ) : L 

[exp] @Ax [(Ri)] 
exp [@PC [(Ri)]] 

Computes the address and pushes it into the stack. 



Example : 

If the SP contains H • 0000 6004, then 

PUSHA H'00FFJ0A00 

changes the contents of memory locations H 1 6000-6003 to H 1 00 
FF 0A 00, and the SP to H' 0000 6000. 

Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 1 I mode | reg 



The register- and mode fields contain the address to be 
pushed onto the stack. 
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RET 
RETurn from subroutine 



RET Operand length(l): Unsized 

Pops a long word from the stack and stores it in the program 
counter (PC). The previous program counter is lost. 



Example : 

If the top of the stack contains E' 00 00 60 00, then 
RET 

changes the contents of the PC to H'6000 and resumes 
execution from that address. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 
Instruction Fields: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 





1 


1 








1 


1 


1 








1 


1 


1 





1 





1 
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RTR 
ReTurn with Restore 



RTR Operand length(l): Unsized 

Pops a long word and word off the stack and then stores them 
in the program counter (PC) and condition code register 
(CCR), respectively. The previous values of the PC and CCR 
are lost. The Supervisor portion of the SR is unaffected. 



Example: 

If the top of the stack contains H'00 00 60 00 00 05, then 

RTR 

sets all of the condition codes of the status register and 
changes the contents of the PC to R' 6000 where program 
execution resumes. 

Condition Codes: 

X N Z V C 



All flags are set according to the word on the stack. 

Instruction Fields: 

15 14 13 12 11 10 987654321 



~0 1 1 llgglllgllTT 
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ROdc 
ROtate 



General Operation: 

Rotates the bits of a specified data register by a count 
contained in either a second data register or an immediate 
expression whose value is in the range 1-8. Memory 
addresses of word length can also be rotated, but only by 
one bit. The direction and category are specified in the 
mnemonics : 

ROL - left logical 

ROR - right logical 

ROLC - left with carry (extend) 

RORC - right with carry (extend) 
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ROL 
ROtate Left logical 




OPERAND 



Bits rotated out of the high order bit go to the carry and 
low order bits. The extend bit is not modified. 
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ROR 
ROtate Right logical 



> 



OPERAND 



Bits rotated out of the low order bit go to the carry and 
high order bits. The extend bit is not modified. 
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ROLC 
Rotate Left with Carry (extend) 




OPERAND 



Bits rotated out of the high order bit go to the carry and 
extend bits. The previous value of extend bit is rotated low 
order bit. 
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RORC 
Rotate Right with Carry (extend) 



> 



OPERAND 



> 



X 



Bits rotated out of the low order bit go to the carry and 
extend bits. The previous extend bit is rotated to low order 
bit. 
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Condition Codes: 



N 



V 



ROL or ROR 
Rotate logical 



X - Not affected. 

N - Set if the most significant bit of the result is set, 

cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Always cleared. 
C - Set according to the last bit rotated out of the 

operand, cleared for a shift count of 0. 
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ROL or ROR 
ROtate logical data 



R0L[1] or 
ROR[l] .Dx, .Dy 

.Dx r #exp[ .W or .L] 



Operand length(l):B f W f L 



Example : 

If D0 contains H' 8000 0000, then 

ROLL .D0, #1 
changes the contents of D0 to H* 0000 0001. 

Instruction Fields 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 110| count |dr size i/r 1 1 reg . 



The count field contains the expression specifying the 
count. 

If the immediate/register field contains 0, the rotate 

count is specified in this field. 

Values are 1-8 where 8 is indicated by 000', values 1-7 

sre standard binary, where 001 = 1, 010 = 2 etc. 

The direction field contains the direction of the 
rotation . 

If the direction field contains 0, the rotation is to 

the right. 

If the direction field contains 1, the rotation is to 

the left. 

The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long word. 

The immediate/register field contains the 
immediate/register. 

If the immediate register field contains 0, the count 

field contains an expression. 

If the immediate register field contains 1, the count 
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field contains a register. 

The register field contains the specifying register to 
be rotated. 
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ROL or ROR 
Rotate logical memory 



ROLtl] 

or 
R0R[1] -@An 

§An+ 

/exp 

[exp]§An[Ri] 

NOTE: rotate of one bit only 



Operand length ( 1 ) : W 



Example: 

If memory address H'5000 contains 11*0042, then 

ROR /H'5000 
changes the contents of H'5000 to H'0021. 
Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1110 11 dr 1 1 mode reg. 



The direction field contains the direction of rotation. 

If the direction field contains 0, the rotation is to 
the right. 

If the direction field contains 1, the rotation is to 
the left. 

The register and mode fields contain the operand to be 
rotated. 
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Condition Codes: 



ROLC or RORC 
ROtate with Carry 



X N 



V 



T 



X 

N 

z 

V 

c 



Set according to the bit last rotated out of the 

operand, cleared otherwise. 

Set if the most significant bit of the result is set, 

cleared otherwise. 

Set if the result is zero, cleared otherwise. 

Always cleared. 

Set according to the last bit rotated out of the 

operand, unaffected for a shift count of 0. 
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ROLCtl] or RORCI1] 
Rotate with Carry data 



ROLCII] or 
RORCI1] .Dx, .Dy 

.Dx, #exp[ .W or .L] 



Operand length(l) :B,W,L 



Example: 

If D0 contains H'08 and the carry bit of the status register 
is set, then 

RORCB .D0, #2 

changes the contents of D0 to H'42. 

Instruction Fields: 

15 14 13 12 11 If 98765432 1 



1110 count dr | size 1 i/r" 1 | reg. 



The count field contains the expression signifying 
register. 

If the immediate/register field contains 0, the rotate 

count is specified in this field. 

Values are 1-8 where 8 is indicated by 000; values 1-7 

are standard binary where 001 = 1, 010 = 2 etc. 

The direction field contains the direction of the 
rotation . 

If the direction field contains 0, the rotation is to 

the right. 

If the direction field contains 1, the rotation is to 

the left. 

The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long word. 

The immediate/register field contains the 
immediate/register . 

If the immediate register field contains 0, the count 

field contains an expression. 
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If the immediate register field contains 1, the count 
field contains a register. 

The register field contains the register to be rotated. 



Radio /hack 

223 



ASSEMBLER-16 



TRS-SO 



® 



INSTRUCTIONS 



ROLC or RORC 
ROtate with Carry memory 



ROLCI1] 

or 
R0RC[1] -@An 

@An+ 

/exp 

texp]@An[(Ri)] 



Operand length(l): W 



NOTE: 



Rotation of one bit only 



Example: 

If the memory address H*6000 contains H'F000 and the carry 
bit of the status register is set, then 

RORC /H'60W 

changes the contents of address H'6000 to H * F00 . 



Instruction Fields: 

15 14 13 12 11 10 9 87654321 



1 







dr 



mode 







reg, 



The direction field contains the direction of the 
rotation . 

If the direction field contains 0, the rotation is to 

the right. 

If the direction field contains 1, the rotation is to 

the left. 

The register and mode fields contain the operand to be 
rotated. 
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SETCC 
SET on condition 



SETcc .Dd Operand Length(l): Byte 

-@Ad 
@Ad+ 
/exp 
[expJ§Ad[(Ri)3 

Tests a condition and sets the destination (byte only) to 
all ones (H'FF) if the condition is true, or to zero if the 
condition is false. 



Example: 

If D0 contains H'0F and the zero bit of the status register 
is set, then 

SETE .D0 

changes the contents of D0 to H'FF. 

Condition Codes: 

X N Z V C 



None of the flags are affected. 



Instruction Fields: 



15 


14 


13 


12 


11 10 9 8 


7 


6 


5 4 3 


2 10 





1 





1 


condition 


1 


1 


mode 


reg. 



The condition field is one of 16 conditions. 

The cc mnemonic can be one of the following: 

Op code - Mnemonic - Description 



0000 
0111 
0110 



- SET 

- SETE 

- SETNE 



- always 

- equal 

- not equal 
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0101 - SETC - carry 

0100 - SETNC - no carry 

1010 - SETP - positive 

1011 - SETN - negative 
1001 - SETV - overflow 
1000 - SETNV - no overflow 

1110 - SETGT - greater than 

1100 - SETGE - greater than or equal 

1101 - SETLT - less than 

1111 - SETLE - less than or equal 

0010 - SETH - higher than 

0011 - SETNH - not higher than 
0001 - SETF - never 

0101 - SETLO - low 

0100 - SETHS - high or same 

The register and mode fields contain the destination 

byte where or 255 is stored. 
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SHdc 
SHift 



General Operation: 

Shifts the bits of a specified data register by an amount 
contained either in a second data register or an immediate 
expression whose value is in the range of 1-8. A memory 
address of word length can also be shifted, but only by one 
bit. In all cases the carry bit (C) as well as the extend 
bit (X) receive the bit shifted out of the operand. The 
direction and category are specified in the mnemonic as 
follows : 

SHL - left logical 

SHR - right logical 

SHLA - left arithmetic 

SHRA - right arithmetic 
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SHL and SHLA 
SHift Left Logical/Arithmetic 



< 





Shifts the zeroes into the low order bit, and the high order 
bit into the carry and extend bit. 

Note: The only difference in SHL and SHLA is in the 
overflow bit after the operation (see condition codes). 
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SHR 
SHift Right Logical 




OPERAND 




Shifts the operand into the carry bit and the extension bit 
Shifts a zero into the most significant bit. 
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SHRA 
SHift Right Arithmetic 



> 



OPERAND 




Replicates the sign bit and shifts the least significant bit 
into the carry and extend bits. 
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Condition Codes: 



N 



V 







SHL or SHR 
SHift logical 



X - Set according to the last bit shifted out of the 
operand, unaffected for a shift count of zero. 

N - Set if the result is negative, cleared otherwise. 

Z - Set if the result is zero, cleared otherwise. 

V - Always cleared. 

C - Set according to the last bit shifted out of the 
operand, cleared for a shift count of zero. 
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SHL or SHR 
SHift logical data 



SHL[1] 

or 
SHR[l].Dx, .Dy 

.Dx f #exp[.W or .L] 



Operand length(l) :B,W,L 



Example: 

If D0 contains H'8132, then 

SHLW .D0, #1 
changes the contents of D0 to H'0264. 
If D0 contains H'8132, then 

SHRW .D0, #1 
changes the contents of D0 to H'4099. 

Instruction Fields: 

15 14 13 12 11 Iff 9 8 7 







1110 count dr size i/r 1 reg. 



The count field contains the expression signifying the 

count. 

If the immendiate/register field contains 0, shift 
count is specified in this field. Values are 1-8 where 
8 is indicated by 000; values 1-7 are standard binary, 
where 001 = 1 010 = 2 etc. 

The direction field contains the direction of the shift. 

If the direction field contains 0, the shift is to the 

right. 

If the direction field contains 1, the shift is to the 

left. 

The size field contains the size of the operation. 

If the size field is 00, it is byte. 

If the size field is 01, it is word. 

If the size field is 10, it is long word. 
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The immediate/register field contains the 
immediate/register. 

If the immediate/register field contains 0, the count 

field contains an expression. 

If the immediate/register field contains 1, the count 

field contains a register. 

The register field contains the register to be shifted. 
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SHift logical memory 



SHLll] 
SHR[1] 



or 



Operand length(l): W 



NOTE: 



-@An 
§An+ 
/exp 
[exp]@An[(Ri)l 

Shift of one bit only 



Example : 

If memory address E' 6000 contains H'7341, then 

SHLW /H' 6(3T0J3f 
changes the contents of address H'6000 to H'E682. 
If memory address H'6000 contains H'7341, then 

SHRW /H'6#00 
changes the contents of address H 1 6000 to H'39A0. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 



1 1 l|dr| 1 1 | mode 



reg, 



The direction field contains the the direction of the 
shift. 

If the direction field contains 0, the shift is to the 

right. 

If the direction field contains 1, the shift is to the 
left. 

The register and mode fields contain the operand to be 
shifted. 
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Condition Codes: 



SHLA or SHRA 
SHift Arithmetic 



N 



V 



X - 

N - 

Z - 

V - 

C - 



Set according to the last bit shifted out of operand, 

unaffected for a shift count of zero. 

Set if the most significant bit of the result is set, 

cleared otherwise. 

Set if the result is zero, cleared otherwise. 

Set if the most significant bit is changed at anytime 

during the operation; cleared otherwise. 

Set according to the last bit shifted out of the 

operand; cleared for a shift count of zero. 
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SHLA[1] 
SHift Arithmetic data 



SHLACE1] Operand length* 1):B, W, L 

or 
SHRA[l].Dx f .Dy 

.Dx, #exp[ .W or .L] 



Example: 

If D0 contains H'8132, then 

SHLAW .D0,#1 
changes the contents of D0 to H'0264. 
If D0 contains H'8132, then 
SHRAW . D0,#1 
changes the contents of D0 to H'C099. 

Instruction Fields: 

15 14 13 12 11 10 987654321 



1 | count |dr[ size|i/r|0 \0 I reg. 



The count field contains the expression signifying the 
count. 

If the immediate/register contains 0, the shift count 

is specified in this field. 

Values are 1-8 where 8 is indicated by 000; values 1-7 

are standard binary, where 001 = 1, 010 = 2 etc. 

The direction field contains the direction of the shift. 

If the direction field contains 0, the shift is to the 

right. 

If the direction field contains 1, the shift is to the 

left. 

The size field contains the size of the operation. 

If the size field is 00, it is byte. 

If the size field is 01, it is word. 

If the size field is 10, it is long word. 
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The immediate/register field contains the 
immediate/register . 

If the immediate/register field contains 0, the count 

field contains an expression. 

If the immediate/register field contains 1, the count 

field contains a register. 

The register field contains the register to be shifted. 
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SHLA or SHRA 
SHift Arithmetic memory 



SHLA[1] 

or 
SHRAtl] -@An 

@An+ 

/exp 

[exp]@An[(Ri)l 



Operand length(l): W 



NOTE: 



Shift of one bit only 



Example: 

If memory address H'60W contains H'7341, then 

SHLAW /H'60W 
changes the contents of address H'6#J2(0 to H'E682. 
If memory address E' 6000 contains H'7341, then 

SHRAW /H'60W 
changes the contents of address E'6000 to H'39A|2f. 

Instruction Fields: 

15 14 13 12 11 10 9 876543 210 



1 1 1 dr 1 1 mode reg. 



The direction field contains the direction of the shift. 

If the direction field contains 0, the shift is to the 

right. 

If the direction field contains 1, the shift is to the 

left. 

The register and mode fields contain the operand to be 
shifted. 
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ST 
STore 



This instruction can be interpreted by the Assembler-16 as 
two different instructions. By the operands used, the 
Assembler-16 chooses which instuction to initiate. 



General Operation: 

ST[1] source, destination 

where the source is the contents of a register and _ the 
destination is an address in memory or another register. 
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ST 
STore data/address register 



ST[1] .Ds, -@Ad 
. Ds , §Ad+ 

.Ds, /exp[ .W or .L] 

.Ds, texp]@Ad[(Ri)] 

.Ds, .Ad 

.Ds, .Dd 

•AS, -§Ad 

.As, §Ad+ 

.As, /exp[ ,W or .L] 

.As, [exp]@Ad[ (Ri)] 

. As , . Ad 

. As , . Dd 



Operand length(l): B, W, L 



(Note: all operations using 
Address Register direct mode 
have 1 = W or L only. ) 



Example: 

If DJ3T contains H'F00F and A0 contains H'6000, then 

STW .D0,@A0+ 

changes the contents of the memory address H'6000 to H'F00F 
and increments AJ2f by 2. 

Condition Codes: 

X N Z V C 



_ * 



00 



X = Unaffected. 

N = Set if the result is negative, cleared otherwise, 

Z = Set if the result is zero, cleared otherwise. 

V = Always cleared. 

C = Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 







size 



destination 
reg. | mode 



source 
mode | reg . 



The size field contains the size loaded. 
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If the size field is 01, it is byte. 
If the size field is 11, it is word. 
If the size field is 10, it is long. 

The destination fields contain the destination 
addressing mode. 

The source fields contain the source register. 
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ST 
STore status register 



ST[1] .SR, Ad Operand length(l): W 

.SR, §Ad+ 

.SR, /exp[.W] 

.SR, [exp]@Ad[ (Ri)] 

. SR , . Dd 



Example 

If the SR contains H'8715, then 

ST . SR,.D0 
changes the contents of D0 to H'8715 

Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 000111 mode | reg 



The register and mode fields contain the addressing 
mode of the destination. 
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STM 
STore Multiple 



STM[1] Rlist, -§Ad 
Rlist, /exp 
Rlist, [exp]@Ad[(Ri)l 



Operand length(l): W,L 



Where Rlist is a set of registers (source) separated by 
commas (.Rx, .Ry...etc). 



Stores the co 
memory locati 
the destinati 
is D0 to D7 
mode where th 
order holds i 
.D3, .D2 give 
word is stipu 
order word of 



ntents of the registers in Rlist in consecutive 
ons beginning with the location specified by 
on operand. The order of the register contents 

and A0 to A7 ; except in the predecrementing 
e order is A7 to A0, D7 to D0. Note that this 
ndependently of the order given in Rlist (.Al, 
s the same results as .D2, .D3, 
lated in the operand length(l), 

the register is stored. 



and 
then 



.Al) 
the 



If 
low 



If the destination operand is addressed in the predecrement 
mode, the registers are stored beginning with the specified 
address, minus two, and continues down through the lower 
addresses. The decremented address register is updated to 
contain the address of the last word stored. 



Example: 

If D0 contains H'FFFF and Dl contains H'00FF, then 

STMW .D0, .Dl, /H'6000 

changes the contents of memory addresses H 1 6000-6003 to H'FF 
FF 00 FF. 

Condition Codes: 

X N Z V C 



None of the flags are affected. 



Instruction Fields: 
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15 14 13 12 11 10 9876543210 



1 1 ft 0f ff 1 |sz| mode | reg 



The size field contains the size of the operation. 
If the size field is 0, it is word. 
If the size field is 1, it is long. 

The register and mode fields contain the source 
addressing mode. 

The Rlist field contains the registers in Rlist as 
follows: 

15 14 13 12 11 10 987654321 



A7 A6 A5 A4 A3 A2 Al A0 D7 D6 D5 D4 D3 D2 Dl D0 



or, for the predecrement mode (where bits corresponding to 
the registers included in Rlist are set), the Rlist field 
contains the registers as follows: 



15 


14 


13 


12 


11 


10 


9876543210 


Djaf 


Dl 


D2 


D3 


D4 


D5 


D6 D7 A0 Al A2 A3 A4 A5 A6 A7 [ 



A word extension is added to the operation word for this 
instruction (Rlist). 
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STP 
STore Peripheral 



STP[1] .Ds, [exp]§Ad 



Operand length (1): W, L 



Loads data from the data register (source) to alternate 
bytes of memory. 



Examples: 

If D0 contains H'01FF 2FF1, and A0 contains H' 6000, then 

STPL .D0,@A0 

changes the contents of memory address H'6000 to H'01, 
H'6002 to H'FF, H'6004 to H*2F, and H'6006 to H'Fl. 



OPERAND LENGTH: L 



DESTINATION ADDRESS 
EVEN 



DATA REGISTER 



A B C D 



> 



> 



or 



A 




B 




C 




D 




ODD 




A 




B 




C 




D 



If D0 contains H'01FF and A0 contains H 1 6000 , then 
STPW .D0,@A0 

changes the contents of memory address H'6000 to H'01 and 
address H'6002 to H'FF. 
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OPERAND LENGTH: W 



DATA REGISTER 



DESTINATION ADDRESS 
EVEN 



A B 



> 



> 



or 



A 




B 












ODD 




A 




B 











Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 876543210 















data reg. 1 1 


sz 





1 add. reg. 


[exp] 



The size field contains the size of the operation. 
If the size field is 0, it is word. 
If the size field is 1, it is long. 

The data register field contains the source of the 
data register. 

The address register field contains the address 
register used in the indirect mode (plus optional 
displacement) . 

The [exp] field specifies the displacement used in 
calculating the operand address. 
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SUB 
SUBtract 



This instruction can be interpreted by the Assembler-16 four 
different ways. The Assembler-16 specifies which is to be 
executed by the operands used. 



General Operation: 

SUB[1] destination, source 

where the source is subtracted from the destination (d) and 
the result is stored in the destination. The size of the 
operation will vary from one operation to another and is 
optionally stipulated. 

The Assembler-16 chooses which instruction to execute 
according to the following guidelines: 



SUB quick 

SUB address 
SUB immediate 

SUB data register 



source is immediate ( indicated 
by a # sign) and in the value 
range 1-8. 

destination is an address 
register . 

source is immediate and 
greater than 8 (more than 
3-bit-data) . 

all remaining subtraction 
operations. A data register is 
always one of the operands. 
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SUB 
SUB quick/ SUB immediate 



SUB[1] .Dd , #exp[.W or .L] Operand length(l): B, W, L 

-@Ad, #exp[.W or .L] 

@Ad+, #exp[ .W or .L] 

/explt.W or .L], #exp2[.W or .L] 

[expl]§Ax[(Ri)], #exp2[.W or .L] 

.Ad, #exp[ .W or .L] (quick only) 



Example: 

If D0 contains H'3F05, then 

SUBB .D0, #3 
changes the contents of D0 to H'3F02. 

Condition Codes: 

X N Z V C 



X - Set the same as carry, set if borrow is generated, 

cleared otherwise. 
N - Set if the result is negative, cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Set if the overflow is generated, cleared otherwise. 
C - Set if borrow is generated, cleared otherwise. 

No flags are affected if Subtraction to Address register is 
made. 



Instruction Fields: SUB quick 

15 14 13 12 11 lft 9 8 76543210 



1 | data I 1 [size| mode | reg 



The data field contains 3-bit data, values 1-8, (001-111 
= 1-7 decimal; 000=8 decimal) 

The size field contains the size of the operation. 
If the size field is 00, it is byte. 
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If 
If 



the 
the 



size 
size 



field 
field 



is 
is 



01, 
10, 



it 
it 



is 
is 



word, 
long word, 



The register and mode fields contain the destination. 

If the size field is byte then the address register 
direct is not allowed. 

If the size field is word and the destination is the 
address Register, the source is sign-extended to 
32-bits (see SUB address register). 



Condition Codes: 



N 



V 



X - Set the same as carry(C), set if borrow is generated, 

cleared otherwise. 
N - Set if the result is negative, cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Set if overflow is generated, cleared otherwise. 
C - Set if borrow is generated, cleared otherwise. 



Instruction Fields: 



SUB immediate 

Operand length(l): B,W,L 



The number of extensions for the immediate data vary 
according to the size of the operation (see data fields) 



15 14 


13 12 11 10 


9 


876543210 





1 





size mode reg. 


+ 


byte data (8 bits) 


or 


word 


data (16 bits) 




1 


or 


long 


word data ( 32 bi 


ts , 


including previous word) 



The size field contains the size of the operation 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long word. 
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The register and mode fields contain the address mode 
of the destination operand. 

The data fields contain the data immediately following 
the instruction: 

If the size field is 00, the data is in the low order 

byte of the immediate word (8 bits). 

If the size field is 01, the data is the entire 

immediate word (16 bits). 

If the size field is 10, the data is the next two 

immediate words (32 bits). 
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SUB 
SUB address register 



SUB[1] .Ad, .As Operand length(l) :W,L 

.Ad, .Ds 

.Ad, -@As 

.Ad, @AS+ 

.Ad, /exp[ .W or .L] 

.Ad, [exp]§Ay[ (Ri)l 

.Ad, exp[@PC[(Ri)]] 

.Ad, #exp[.W or .L](SUB immediate only) 

Note that an address register is always the destination 
operand. 



Example: 

If AjZT contains H'003F 0010 and Al contains E' 0000 0001, then 

SUBL .A0, .Al 
changes the contents of A0 to H'003F 000C. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 

15 14 13 12 11 



10 











reg. (d) 



size 



mode 



reg. 



The reqister(d) field contains the destination operand. 
It can be any address register. 

The size field contains the size of the operation. 

"if - the size field is 011, it is word. The source 
operand is sign-extended (see EXT) to fill 32 bits of 
the address register. 
If the size field is 111, it is long word. 
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The register and mode fields contain the address mode 
of the source operand. 
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SUB 
SUB data register 

Operand length* 1):B, W, L 

SUB[1] .Dd, .Ds 

.Dd, -§As 

.Dd f @As+ 

.Dd, /exp[.W or .L] 

.Dd, [exp]@Ay[(Ri)l 

.Dd, exp[§PC[(Ri)ll 

.Dd, .As 

operand list continued in next column 



-@Ad ,.DS 

@Ad+ , . Ds 

/exp[.W or .L],.Ds 

[exp]@Ax[ (Ri)],.Ds 



A data register is always one of the operands. 

Example: 

If D0 contains H'3F and Dl contains H'10; then 

SUBB .D0, .Dl 
changes the contents of D0 to H'2F. 

Condition Codes: 



N 



V 



X - Set if a borrow occurred, cleared otherwise (same as 

carry (C) ) . 
N - Set if the result is negative, cleared otherwise. 
Z - Set if the result is zero, cleared otherwise. 
V - Set if an overflow is generated, cleared otherwise. 
C - Set if a borrow occurred, cleared otherwise. 



Instruction Fields: 

12 11 



15 14 13 



IV 







0L 



reg. 



size/op I mode 



reg 



The register field contains the data register. 

The size/op field contains the size of the operation and 

specifies the destination of the result: 
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Byte 

000 
100 



Word 
~0W 

ljari 



Long Word 

njar 



Destination 
data register 
second operand 



The mode and register fields contain the location of 
the second operand. 

If the second operand is the source operand and its 
size is one byte, the address register direct 
addressing mode is not permitted. 
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SUBC 
SUBtract with Carry 



SDBC[1] .Dd, .Ds Operand Sizes: B, W, L 

-@Ad, -@As 

Subtracts the source and the carry bit from the destination, 
The results are stored in the destination location. 



Example: 

If D0 contains H'3F, Dl contains H 1 10 , and the carry bit of 
the status register is set, then 

SUBCB .D0, .Dl 

changes the contents of D0 to H'2E. 

Condition Codes: 

X N Z V C 



X - The same as carry; set if carry generated, cleared 

otherwise. 
N - Set if the result is negative, cleared otherwise. 
Z - Cleared if the result is nonzero, unchanged otherwise. 
V - Set if overflow is generated, cleared otherwise. 
C - Set if carry is generated, cleared otherwise. 



Instruction Fields: 

15 14 13 12 11 10 9876543210 



10 1| reg.(d) |1| size I 1 r/m| reg. ("il 



The R/M field contains the operand addressing mode. 

If the R/M field is 0, the operation is from data 
register to data register. 

If the R/M field is 1, the operation is from memory to 
memory . 

The size field contains the size of the operation. 
If the size field is 00, it is byte. 
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If the size field is 01, it is word. 

If the size field is 10, it is long word. 
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SUBD 
SUBtract Decimal (BCD) with extend 



SUBD .Dd f .Ds Operand sizes s B 

-@Ad, -@As 

Subtracts the source and the extend bit from the 
destination. The result is stored in the destination. 
Binary coded decimal arithmetic is used. The operation 
size is byte only. 



Example: 

If D0 contains 41, Dl contains 35, and the carry bit is 
clear, then 

SUBD .D0, .Dl 

changes the contents of D0 to 06. 

Condition Codes: 

X N Z V C 



U * U 



X - Same as carry; set if borrow (BCD) occurs, cleared 

otherwise. 
N - Undefined. 

Z - Cleared if the result is nonzero, unchanged otherwise, 
V - Undefined. 
C - Set if borrow (BCD) occurs, cleared otherwise. 



Instruction Fields: 

1 5 14 13 12 11 10 9 8 7 6 5 4 3 2 ± $ 
1 j reg.(d) 1 1 1 r/m| reg. ( s ) | 



The reqister(d) field contains the destination register, 
If the R/M field is 0, reg(d) is a data register. 
If the R/M is 1, reg(d) is address register in the 
predecrement addressing mode. 

The R/M field contains the operand addressing mode. 
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If the R/M field is 0, the operation is from data 

register to data register. 

If the R/M field is 1, the operation is from memory to 

memory. 

The register(s) field contains the source register. 

If the R/M field is 0, register (s) is a data register. 
If the R/M field is 1, register (s) is an address 
register in predecrement addressing mode. 
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TEST 
TEST an operand 



TEST(l) .Dn Operand length(l): B f W f L 

-@An 
@An+ 

/exp[ .W or .L] 
[exp]@An[ (Ri)] 

Compares the operand to zero. Sets the condition codes 
according to the results. No results are saved. 



Example : 

If D0 contains H 1 00 , then 
TESTB .D0 

sets the zero bit of the status register and clears all 
other status bits. 

Condition Codes: 



X N 







X 

N 
Z 
V 
C 



Not affected. 

Set if the operand is negative, cleared otherwise. 

Set if the operand is zero, cleared otherwise. 

Always cleared. 

Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 











10 1 



size 



mode 



reg. 



The size field contains the size of the operation, 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long. 
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The register and mode fields contain the addressing 
mode of the operand being tested. 
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TESTS ET 
TEST and SET indivisible 



TESTSET .Dn Operand length(l): B 

-@An 
@An+ 

/exp[ .W or .L] 
[exp]@An[ (Ri)] 

Tests the operand (byte) for negative and zero conditions, 
and then sets the most significant bit of the byte. The 
operation is indivisible (noninterruptable) in a multi-user 
environment. 



Example: 

If D0 contains E' 00 , then 

TESTSET .D0 

sets the zero bit of the status register and changes the 
contents of D0 to H'80. 



Condition Codes: 



N 



_ * 



* 1 



X 

N 

Z 
V 
C 



Not affected. 

Set if the most significant bit of the operand is set, 

cleared otherwise. 

Set if the operand zero, cleared otherwise. 

Always cleared. 

Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 _0_ 



reg. | 















mode 



The register and mode fields contain the operand 
addressing mode. 
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TESTl 
TEST bit 



General Operation: 

Tests a bit (specified by the source) in the destination. 
The state of the tested bit is reflected in the Z condition 
code. If a data register is the destination, then the bit 
numbering is modulo 32 (long word). If the destination is in 
memory, the operation is performed using modulo 8 (byte) and 
the contents of the byte are unchanged. 



TESTl [1] 



source(s) destination (d) 



Condition Codes: 

X N Z V C 






X 

N 
Z 
V 
C 



Not affected. 

Not affected. 

Set if the bit tested is zero, cleared otherwise. 

Not affected. 

Not affected. 
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TESTl data register 



TESTltl] .Ds f -@Ay 

.Ds, @Ay+ 

. Ds , /exp 

.Ds, [exp]@Ay[(Ri)] 

.Ds, exp[@PC[ (Ri)] ] 

.Ds, .Dd 



Operand length(l): B for 
memory destination 
L for data register 
destination 



The source is a data register (specified as the first 
operand) . 



Example: 

If Dj3f contains E'0000 0005 and Dl contains ft* 0000 0001, then 

TESTlL . D0, .DL 
sets the zero bit of the status register. 

Instruction Fields: 

15 14 13 12 11 10 9876543210 



1 reg.(s) | 1[ 0\ 0\ mode | regT 



The register (s) field contains the data register which 
contains the bit number 

The register and mode fields contain the destination 
operand. 
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TESTl immediate 



TESTltl] #exp, Dd 

#exp, -§Ad 

#exp, @Ad+ 

#expl f /exp2 

#expl, [exp2]@Ad[(Ri)] 

#expl, exp2[@PC[(Ri)]] 



Operand length(l): B for 
memory destination L for 
Data Register destination. 



Note: source (first operand) is immediate, requires a second 
word of instruction: 



Example: 

If D0 contains H'05, then 

TEST1L #3, .D0 
sets the zero bit of the status register. 

Instruction Fields: 

15 14 13 1 2 11 10 9876543210 



/-\ 






91 


91 


91 


1 





91 


mode 


reg. 


bit number 



The register and mode fields contain the destination 
The bit number field specifies the bit number. 
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TESTCLRl 
TEST and CLeaR bit 



General Operation: 



Tests a bit (specified by the source) in the destination. 
The state of the tested bit is reflected in the Z conditi 
code. After the test, the bit is cleared. If a data 
register is the destination, then the bit numbering is 
modulo 32 (long word). If the destination is in memory, 
the operation is performed using modulo 8 (byte) and the 
byte is written back to the location. 



TESTCLRl [1] 



source, destination 



Condition Codes: 

X N Z V C 



* _ _ 



X 

N 
Z 
V 
C 



Not affected. 

Not affected. 

Set if the bit tested is zero, cleared otherwise, 

Not affected. 

Not affected. 
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TESTCLRl data register 

TESTCLRltl] .Ds, -@Ay Operand length: B for memory 

.Ds, §Ay+ destination. L for Data 

.Ds, /exp Register destination. 

.Ds f [exp]@Ay[(Ri)] 

.Ds, .Dd 

The source is a data register (specified as the first 
operand ) . 



Example: 

If D0 contians H'05 and Dl contains H'lF, then 

TESTCLRlL .Dj2f, .Dl 

changes the contents of Dl to H'lF and sets the zero bit of 
the status register. 

Instruction Fields: 

15 14 13 12 11 1JT 9 8 7 6 5 4 3 2 1 



0\ reg.(s) | 1| 1| 0\ mode 1 reg. | 



The register(s) field contains the data register which 
contains the bit number. 

The register and mode fields contain the destination 
operand. 
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TESTCLRl immediate 

TESTCLRltl] #exp, .Dd Operand length(l): B for memory 

#exp, -@Ad destination. L for data 

#exp, §Ad+ register destination. 

#expl f /exp2 

#expl, [exp2]§Ad[(Ri)l 

The source (first operand) is immediate, and requires a 
second word of instruction: 



Example : 

If D0 contains H'F0, then 
TESTCLR1L #3, . D0 
sets the zero bit of the status register (D0 is unchanged) 

Instruction Fields: 

15 14 13 12 11 10 9876543210 



1 000101 mode I reg 



bit number 



The register and mode fields contain the destination, 
The bit number field specifies the bit number. 
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TESTN0T1 
TEST and NOT bit 



General Operation: 

Tests a bit (specified by the source) in the destination. 
The state of the tested bit is reflected in the Z condition 
code. After the test, the bit is changed (NOT). If a data 
register is the destination, then the bit numbering is 
modulo 32 (long word). If the destination is in memory, the 
operation is performed using modulo 8 (byte) and the byte is 
written back to the location. 



TESTN0T1E1] 



source, destination 



Condition Codes: 

X N Z V C 



_ _ * _ _ 



X 

N 
Z 
V 
C 



Not affected. 

Not affected. 

Set if the bit tested is zero, cleared otherwise. 

Not affected. 

Not affected. 
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TESTNOTl data register 

TESTNOTl[l] .Ds, -@Ay Operand length(l): B for memory 

.Ds, @Ay+ destination. L for Data 

.Ds, /exp Register destination 

.Ds, [exp]@Ay[ (Ri)l 

.Ds, .Dd 

The source is a data register (specified as the first 
operand) . 



Example: 

If D0 contains H*04 and Dl contains H'04, then 
TESTN0T1L . D0, .Dl 

changes the contents of Dl to H'14 and sets the zero bit in 
the status register. 

Instruction Fields: 

15 14 13 12 11 10 9876543210 



0\ reg.(s) | 1| 01 II mode | reg 



The reqister(s) field contains the data register which 
contains the bit number. 

The register and mode fields contain the destination 
operand. 
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TESTNOTl immediate 



TESTNOTl[l] #exp f .Dd Operand length(l): B for memory 

#exp, -@Ad destination. L for Data 

#exp, §Ad+ Register destination. 

#expl, /exp2 

#expl, [exp2]§Ad[(Ri)l 

The source (first operand) is immediate, and requires a 
second word of instruction: 



Example: 

If D0 contains H'F0, then 

TESTN0T1L #5, .D0 

changes the contents of D0 to H'D0 and sets the zero bit of 
the status register. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



| 1 FTTTXI mode 1" req, 
0\ bit number 



The register and mode fields contain the destination, 
The bit number field contains the bit number. 
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UNLK 
UNLinK 



UNLK .An 



Operand length(l): Unsized 



Undoes A LINK. Loads the stack pointer from the specified 
address register. The address register is loaded with the 
long word pulled from the top of the stack. 



Example: 

If A0 contains H ' 0000YY00 and the memory address E'0000 FF00 
contains H'00 FA 00 00, then 



UNLK 



.A0 



changes the contents of A0 to H'00FA 0000 and the SP now 
contains H'0000 FF04. 



Condition Codes: 

X N Z V C 



None of the flags are affected. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 







1 ¥ 



T~$~ 



11 



reg, 



The register field contains the address register through 
which the unlinking is to be done. 
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XCH 
eXCHange 



This instruction can be interpreted by the Assembler-16 as 
two different instructions. The operands used determine 
which instruction is executed. 



XCH[l].Ax, .Ay 
.Ax f .Dy 
.Dx, .Dy 
.Dx, .Ay 



eXCHange registers Operand length(l): L 



The contents of two Registers (32 bits) are exchanged. 

Example: 

If D0 contains H'FF00 FF00 and Dl contains H*12FF 0000, then 
XCH .D0, .Dl 

changes the contents of D0 to H'12FF 0000 and Dl to H ' FF00 
FF00. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Fields: 



15 


14 


13 


12 


11 10 9 


8 


7 6 5 4 


3 


2 10 


1 


1 








1 req. X 


1 


op/mode 




reg. Y 



The register X field contains one of the registers. 

If the exchange is between the data register and address 

register, the data register is specified here. 

The op/mode field specifies the type of exchange. 

If the op/mode field is 01000, it is data registers. 
If the op/mode field is 01001, it is address registers. 
If the op/mode field is 10001, it is both data register 
and address register. 
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The register Y field contains the second register. If 
the exchange is between address and data registers the 
address register is specified here. 
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XCH[1] .Dn 
eXCHange words 



Operand length(l): W 

Exchanges the high order word (16 bits) and low order words 
(16 bits) in a data register. 



Example: 

If D0 contains H'F00F 0000, then 

XCH . D0 
changes the contents of D0 to E'0000 F00F. 

Condition Codes: 

X N Z V C 



_ * 



T~W 



X - Not affected. 

N - Set if the most significant bit of the 32-bit result is 

set, cleared otherwise. 
Z - Set if the 32-bit result is zero, cleared otherwise. 
V - Always cleared. 
C - Always cleared. 



Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 00001000] req.~T 



The register field contains the data register used. 
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XOR 
exclusive OR logical 



This instruction can be interpreted by the Assembler-16 as 
two different instructions. By the operands used, the 
Assembler-16 determines which instruction to execute. 



General Operation: 

X0R[1] destination (d) , source(s) 

where the source is exclusive ORed to the destination. The 
result is stored in the destination. 

The Assembler-16 chooses which instruction to initiate by 
the following guidelines: 

XOR immediate if the source is immediate 

(indicated by a # sign). 

XOR data if the source is a data 

register. 

Condition Codes: (Identical for both operations) 
X N Z V C 



_ * 







X - Not affected. 

N - Set if the most significant bit of the result is set, 

cleared otherwise. 
Z - Set if result is zero, cleared otherwise. 
V - Always cleared. 
C - Always cleared. 
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XOR 
exclusive OR data 



XOR[l] .Dd, .Ds 
-@Ax, .Ds 
@Ax+, .Ds 
[exp]§Ax[ (Ri)], .Ds 
/exp[ .W or .L] , .Ds 



Operand length* 1): B, W, L 



Example: 

If D0 contains H'F5 and Dl contains H'07, then 

XORB .D0, .Dl 
changes the contents of D0 to H'F2. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



10 111 reg.(s) [ size/op | mode ] reg. | 

The register(s) field contains the data register. 

The size/op field is as below: 

Byte Word Long Word 

100 101 110 

The register and mode fields contain the destination 
operand. 
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XOR 
exclusive OR immediate 



X0R[1] .Dd, #exp[.W or .L] 

-§Ax, #exp[.W or .L] 

@Ax+, #exp[.W or .L] 

/explt.W or .L], #exp2[.W or .L] 

[expl]@Ax[ (Ri)], #exp2[.W or .L] 

.CCR, #exp[.W or .L] 



Operand length(l): B, VI, L 



(1=B, W only) 



Example : 

If D0 contains H'1B5A, then 

XORW .D0, #H'F0F0 
changes the contents of D0 to H'EBAA. 

Instruction Fields: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 












1 





1 





size 


mode 




reg. 1 


+ 




byte 


data 


(8 


bits) 


or 


word 


data 


(16 


bits) 
















or 


long 


word 


data (32 


bi 


ts , 


inc 


rluding 


previous 


word) 



The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long word. 

The register and mode fields contain the address mode 
of the destination operand. 

The data fields contain the data immediately following 
the instruction: 

If the size field is 00, the the data is the low order 

byte of the immediate word (8 bits). 

If the size field is 01, the the data is the entire 
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immediate wcrd (16 bits). 

If the size field is 10, the the data is the next two 

immediate words (32 bits). 
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CHAPTER 9/ DIRECTIVES 



Assembler directives are commands to the Assembler-16 (and 
not 68000 machine instructions). A directive may produce 
code, affect the listing, or change the state of the 
assembly. 

Directives may appear anywhere in the assembly source 
program, except for the END directive which must be the last 
statement of the program. 

Each directive has a unique syntax. 



Program Sections 

Each source program processed by the Assembler-16 consists 
of one or more program sections (PSECTS). They are defined 
by the ASECT, DSECT and RSECT directives. 

The ASECT directive defines the absolute section; there is a 
maximum of one. The RSECT defines a relocatable section; 
there may be zero or more relocatable sections in a program, 
but only one per assembly. The DSECT directive defines a 
dummy section; there may be zero or more dummy sections in a 
program. Note: no object is output for a DSECT. 

A section of code is delineated by section directives. Code 
in the source program following a section directive belongs 
to the directive-defining section until another section 
directive is encountered. 

Sections may be named or blank. Each named, relocated 
section is assumed to be independently relocatable from all 
other relocatable sections which are blank or named 
differently. 

Only one blank (unnamed) relocatable section is recognized. 
RSECT directives with different names define different 
sections. The name of a section may not match the name of 
any other section of a different type. 

Absolute (ASECT) section is used to generate non-relocatable 
code or data references. Addresses of data or code inside 
an absolute section cannot be altered by the linker or 
loader. It is recommended, therefore, that ASECT sections 
precede RSECT sections when coding. 
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Relocatable (RSECT) sections are used to produce object code 
which is relocatable by the linker or loader. 

DSECT (dummy section) is used to generate absolute offsets. 
No object is output for a DSECT. 

If neither an RSECT, DSECT, or ASECT statement begins an 
assembly, the blank (unnamed) RSECT is assumed. 
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ASECT 
Absolute SECTion 



[global label] ASECT 

Opens an absolute segment and sets the current location 
counter to zero. Code assembled in the absolute segment may 
not be relocated by the linker or loader. 

The label, if any, is defined at the current location 
counter after the segment is opened. 



Example: 

MAIN ASECT 

defines the beginning of an absolute segment with the name 
MAIN. 
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RSECT 
Relocatable SECTion 

[global label] RSECT 

A relocatable segment is opened with the name defined by the 
label, if present, with the location counter initialized to 
zero. 



Example : 

SORT RSECT 

defines the beginning of a relocatable segment with the name 
SORT. 
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DSECT 
Dummy SECTion 



[global label] DSECT 

Opens a dummy segment with the name defined by the label, if 
present, with the program counter initialized to zero. 



Example: 

EQUATES DSECT 

defines the beginning of a dummy segment with the name 
EQUATES . 



Radio /hack 

285 



ASSEMBLER-16 DIRECTIVES 

TRS-SO ® 



ORG 
ORiGinate program 



ORG exp 



Sets the current location counter to the value defined by 
the expression. The current program section is not changed. 

If the current program section is absolute, the expression 
must be absolute. 

If the current program section is relocatable, the 
expression must evaluate to relative to this section. 

The expression must be pass-one defined. In an absolute 
section, exp is the address of the beginning of the ASECT. 
In a relocatable section, exp is the number of bytes between 
the RSECT and a preceding section (if there is one) or 
between ( if no preceding section). 

Example: 

ORG H • A000 
sets the current location counter to H * A0 00 . 
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RES 
REServe 



[label] RES[m] exp 

where 

m = B, W, L or null 

Increments the current location counter by the number of 
bytes specified by the length indicator and the value of the 
expression. The length indicator, m, defaults to W. When m 
is W or L, the PC is set to an even number before the space 
is reserved by incrementing by 1 if PC is odd. 

Defines the label at the current location counter (even 
boundary if m = W or L). 

The expression must be a pass-one defined absolute value. 

Example: 

TABLE RESW 100 

reserves a block of memory which is 200 bytes long, the 
first byte of which is known as TABLE. 
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EQU 
EQOate 

global label EQU[m] exp 

or 
global label EQU[m] .register 

where 

m = B, W, L, U or null 

Defines the label to take on the value of the expression or 
register in the operand field. If the length indicator, m, 
is specified, then the label takes on that length attribute. 
If the length indicator is absent, the label assumes the 
length attribute of the expression or the register symbol. 

The expression must be pass-one defined. 

Example: 

SLASH EQU ' / 

equates the word SLASH with the code for "/". 
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END 
END of program 

[label] END [exp] 

Defines the label, if present, at the current location 
counter. The END directive is the last valid statement in 
the assembly. An error message is output on every source 
line after this. 

If an end-of-file on input is reached prior to an END 
statement, a warning message is generated, and an END record 
is assumed. 

The optional expression operand defines the entry point 
address, to which control is transferred after loading. 

Note: When several programs are linked the exp is taken 
from the last program included. 



Example: 

FINISH END ENTRY1 

defines the end of the program to be here, at statement 
label FINISH, and defines ENTRY1 to be the entry point of 
the program. 
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TITLE 
TITLE of page 



TITLE 'string 1 
"string" 

Causes a new page on the listing output, and the character 
string is set in the subheader of each subsequent page of 
the listing. 

The character string should not be packed. It should begin 
and end with matching quotes, either single or double. 

The TITLE directive is the first line past the page header 
on the new page. 



Example: 

TITLE 



•DATA FORMAT ROUTINE 1 



causes a new page to be printed, and the heading "DATA 
FORMAT ROUTINE" to be printed at its top. 
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PAGE 
new PAGE 



PAGE 



Causes a new page on the listing output. The PAGE directive 
is the first line past the page header on the new page. 



Example: 

PAGE 
causes a new page to be printed. 
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DATA 
define DATA 

[label] DATA[m] expl[ ,exp2[ , . . . ,expn] ] 

where 
m = B, W, L or null 

Computes the values associated with the operand expressions 
and stores them in consecutive memory locations. Each 
expression occupies a byte, word, or long word depending on 
the length indicator: B, W, or L respectively. If no length 
indicator is given, default is W. If W or L is specified, 
the PC is adjusted to an even boundary before generation of 
data. The optional label takes on the value of the current 
location counter after adjustment (if any). 

The length attribute of the label is set to B, W, or L 
according to the length indicator. 

If the value is too large for the specified field, it is 
truncated and a warning is generated. 

Example : 

P0WER2 DATAB 1,2,4,8,16 

fills 5 bytes beginning at location P0WER2 with the numbers 
given . 
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RDATA 
Repeat DATA 



[label] RDATA [m] expl, exp2 

where 

m = B f W, or null 

Computes the value associated with the operand expression 
exp2 and stores it in 'expl' consecutive memory locations. 
Each exp2 occupies a byte, word or long word depending on 
the length indicator (B, W, or L respectively). If no 
length indicator is given, the default is W. If W or L is 
specified, the PC is adjusted to an even boundary before 
generation of data. The optional label takes on the value 
of the current location after adjustment (if any). 

The length attribute of the label is set to B, W, or L 
according to the length indicator. 

If the value is too large for the specified field, it is 
truncated and a warning is generated. 

Note: expl must be a pass-one defined absolute value. 



Example : 

TABLE 2 RDATAL 100, 

defines a 400 byte area of memory as TABLE2 and fills it 
with zeroes. 
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TEXT 
TEXT string 

[label] TEXT 'string' 

"string" 

P' string' 

P"string" 

Stores the operand character string in memory in either 
unpacked or packed format. In unpacked format, the string 
operand begins with a quote (single or double). 

Two consecutive quotes inside a character string represent 
one quote character as part of the string. Characters are 
stored one ASCII, zero-parity character per byte. In packed 
format, the characters are first encoded and then packed, 
modulo 40, three characters per word, occupying an integral 
number of words with blank fill on the right as necessary. 
The packing algorithm encodes the characters as: 



letter 


f (letter) 


A-Z 


1-26 


0-9 


27-36 


$ 


37 


- 


38 




39 


all others 






These encoded letters are packed three to a word by setting 
the word equal to: 

<(f (Cl)*40+f(C2))*40)+f(C3) 

where multiplication and addition employ unsigned 16-bit 
arithmetic . 

If a label is present, it is defined at the current location 
counter, with a length attribute of B. 

Null character strings are valid, no output being generated. 

Example: 

MSGl TEXT 'INSERT NEW DISK 1 
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defines a block of memory called MSGI and fills it with the 
string. 
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TEXTC 
TEXT string with Count 

[label] TEXTC 'string' 

"string" 

P' string' 

P"string" 

Stores the characters of the operand as in the TEXT 
directive, preceded by a count of the number of characters 
in the string. 

If the string is packed, the count occupies one word. If it 
is unpacked, the count occupies one byte. 

If a label is present, it is defined at the current location 
counter with a length attribute of B. 

Null character strings are valid, a one-word count of 
being generated. 



Example: 

LINEIN TEXTC 'STRING LENGTH' 

defines a block of memory call LINEIN and fills it with the 
string, the first element being the string length. 
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REF 
REFerence external symbol 



global label REFm 

where 
m = B, W, L or null 

The required label is declared to be an external symbol with 
a length attribute as defined by the length indicator, m. 
If no length attribute is specified, the default is W. All 
references to label in code-generating instructions will be 
updated by the linker. This restricts the complexity of 
expressions in which a label may appear to that which is 
manageable by the linker. 

The reference is assumed to be a relocatable address. 



Example: 

USERl REFW 

declares the word variable USERl to be an external variable. 



Radio /hack 

297 



ASSEMBLER-16 DIRECTIVES 

TRS-SO ® 



DEP 
DEFine external symbol 

DEF symbolll , symbol 2 [... ,symboln]] 

The symbol(s) are declared to external symbols which are 
defined within this module. The symbols must be global 
labels, and may be either absolute or relocatable. Symbols 
must be DEFined in order to REFerence them from other 
modules . 

FORM symbols and user-defined op code directives cannot be 
DEF'd. Symbols that are external (i.e., declared by REF) 
cannot be DEF'd in the same assembly. 

Example : 

DEF ENTRYl, ENTRY2 

defines ENTRYl and ENTRY2 to be external labels defined 
within the current. 
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COPY 
COPY filename 



COPY filespes 

where filespec is any valid TRSDOS-16 file specification 
consisting of filename and extension (no password, drive 
number, or diskname). 

Copies the source file specified by filename into the input 
stream after this COPY statement and before the next 
statement in the normal input stream. 

There is a maximum of nine COPY statements in the assembly. 
No nesting of COPY statements is allowed. 



Example: 

COPY STDIO 

copies the file STDIO into the current location, in the 
program. 
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FORM 
FORMat definition of data 

global label FORMm expl [ , exp2 [ . . . , expn ] ] 

where 
m = B, W, L or null 

The FORM directive enables the user to define bits of data. 
The global label is defined to be a FORM-symbol (mnemonic). 
AFORM-symbol (mnemonic) must be defined by the FORM 
directive before it is referenced in a program. 

The operand expressions (exp) specify bit-field sizes. They 
must be absolute and pass one-defined, and the sum of the 
expression values must be 8, 16, or 32 as the length 
indicator, m, is: B, W, or L respectively. If no length 
attribute is specified, the default is W. Each expression 
defines the number of bits occupied by a field in the 
generated user instruction which employs this form. Up to 
32 fields may be defined for m = L; up to 16 fields may be 
defined for m = W; up to 8 fields may be defined for m = 8. 

The first expression, (exp) describes the high-order bit 
field of the generated object data; the second (if any) 

expression the next contiguous field; until m is 

filled. 

Example: 

X4X12 FORMW 4, 12 

describes a word with two fields of 4 (high order) and 12 
bits respectively. X4X12 can then be used as a mnemonic 
(Formal Symbol) to generate a word format as follows: 

LabelA X4X12 3 H 1 300 

where the bit fields will be 0011 and 001100000000; the 
first field is filled with a decimal 3 and the second with a 
hex 300. 
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Extended Use of FORM-symbol (second level directive) 

global label FORM-symbol expl [ , exp2 [ . . . , expn ] ] 

The global label (second level mnemonic) is defined as yet 
another code-generating Assembler instruction. The code 
generated by a second level mnemonic is byte, word, or long 
word (depending upon how the FORM-symbol was defined.) 

Note: The FORM-symbol must have been previously defined in 
a FORM directive. 

The number of expressions appearing as operands must match 
the number of bit fields defined in the FORM directive. Each 
expression may contain reference parameters (&1, &2 ...,&n). 



When a second level mnemonic is used in source code its 
operands replace the reference parameters (&1, &2...,&n) of 
the second-level directive. The data generated are the bit 
fields defined by the new expressions list. 

With the earlier Example: 

X4X12 FORMW 4,12 
you can create a second mnemonic: 

SECLEV X4X12 3, &1+H'20 

The global label (SECLEV) becomes the second level mnemonic, 
used as follows: 

[label] SECLEV H ' 300 

where the operand H'300 replaces the reference parameter &1. 
The resulting data (bit fields) would be: 3, H 1 300+E' 20 or 
0011 001100100000. 

Note: The sizes of bit fields (4, 12) were given in the 
FORM directive. 
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PRIVILEGED INSTRUCTIONS 
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As was said in an earlier chapter, the MC68000 
microprocessor has two modes of operation: the user mode, 
and the supervisor mode. This chapter deals with the 
additional instructions generated by the Assembler-16. They 
are available in the supervisor mode and are called 
"privileged" instructions. 

The TRSDOS-16 Operating System works in the supervisor mode. 
However, in order to protect itself it does not permit the 
user to enter this mode. Therefore, there is no way to 
enter the supervisor mode while operating under TRSDOS-16. 
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AND 
AND status register 

AND[1] .SR, #exp[.w or .L] Operand length(l): B, W 

Performs a logical AND on the immediate expression (#exp) 
and the status register (SR), and stores the result in the 
status register. 

Example: 

If the SR contains H'2015, then 

ANDB .SR, #H'F6 
changes the contents of the SR to H'2014. 

Condition Codes: 

X N Z V C 



All of the flags are set according to the operation, 



Instruction Field: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 
| P 9 9 1 \ size | mode | reg~7~ 



word data (16 bits) 



The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long. 

The register and mode fields contain the destination 
(status register) 111 100. 

The word data field contains #exp. 
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LD 
LoaD status register 

LD[1] Destination source Operand length(l): W 

LD[1] .SR, #exp[.Wor .L] 

.SR, -@As 

.SR, @As+ 

.SR, /exp[ .W or .L] 

.SR, [exp]@As[ (Ri)] 

.SR f exp[§PC[ (Ri)]] 

Loads the contents of the source (second) operand into the 
status register (SR). The source operand is a word. All 
bits of the status register are affected. 



Example : 

If the SR contains H* 2310, then 

LDW .SR, #H'2015 
changes the contents of the SR to H'2015. 

Condition Codes: 

X N Z V C 



All flags are set according to the source operand. 



Instruction Field: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 11011| mode 



reg, 



The register and mode fields contain the address of 
the source operand. 
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MOV 
MOVe status register 

MOV[l] Destination, Source 

M0VI1] .SR, .Ds Operand length(l): W 

Moves the contents of a data register to the status 
register. 



Example: 

If D0 contains H'2015, then 

movw . sr , . Djar 

changes the contents of the SR to H'2015, 

Condition Codes: 

X N Z V C 



***** 



All of the flags are set according to the source operand, 



Instruction Field: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 110 1 1~1 Sodi 



reg. 



The register and mode fields contain the source data 
register. 
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MOV 
MOVe user stack pointer 



MOV[l] Destination, source 
MOV[l].Ad, .USP 
.USP, .As 



Operand length(l): L 



Moves the contents of the user stack pointer (USP) to or 
from an address register. 



Example : 

If the USP contains H'00FF 0000, then 

MOVL . A0 , . USP 
changes the contents of A0 to H*00FF 0000. 

Condition Codes: 

X N Z V C 



None of the flags are affected, 



Instruction Field: 

15 14 13 12 11 10 9 8 











1 1 1 |dr 







re 9- 



The direction field contains the direction of the move. 

If the direction field contains 0, the contents of the 
user stack pointer is moved from an address register. 
If the direction field contains 1, the contents of the 
user stack pointer is moved to and address register. 

The register field contains the address register number 
used in the operation. 
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OR 
inclusive OR status register 

OR[l] .SR, #exp[.W or .L] Operand length(l): B, W 

Performs a logical OR on the immediate expression (#exp) and 
the status register (SR), and stores the result in the 
status register. 

Example: 

If the SR contains H 1 2015, then 

ORW .SR, #H'A000 
changes the contents of the SR to H'A015. 

Condition Codes: 

X N Z V C 



All of the flags are set according to the operation 



Instruction Field: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



000000910 | size | mode | reg 



word data (16 bits) 



The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01, it is word. 
If the size field is 10, it is long. 

The register and mode fields contain the destination 
status register. Ill 100 

The word data field is the expression. 
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RESET 
RESET external devices 



RESET Operand length(l): unsized 

Resets all external devices. The processor state, other 
than the program counter, is unaffected and execution 
continues with the next instruction. 



Example : 

If the PC contains H' 6004, then 

RESET 
resets all external devices and increments the PC to H*6006. 

Condition Codes: 

X N Z V C 



None of the flags are a affected, 



Instruction Field: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 1100111000 0| 
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RETI 
RETurn from Interrupt 



RETI Operand length(l): unsized 

Pulls the status register (SR) and the program counter (PC) 
from the system stack. The previous status register and 
program counter are lost. All bits in the status register 
are affected. 



Example: 

If the SP points to memory address H 1 6000 which contains 
E'00 15 00 00 F0 00, then 

RETI 

changes the contents of the SR to H'0015 and the PC to 
B.'¥000. 



Condition Codes: 

X N Z V C 



***** 



All of the flags are set according to the content of the 
word on the stack. 



Instruction Field: 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 








1 








1 


1 


1 








1 


1 


1 








1 


1 
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WAIT 
WAIT for interrupt 

WAIT #exp[.W or .L] Operand length(l): unsigned 

Moves the immediate operand (#exp) into the entire status 
register (SR). The program counter (PC) is advanced to the 
next instruction, and the processor stops until an 
interrupt, reset or trace occurs. 

A trace exception will occur if the trace state is on when 
the WAIT is executed. If an interrupt request arrives with 
a priority higher than the current processor priority, an 
interrupt exception occurs. If the bit corresponding to the 
S-bit of #exp is off, execution of the instruction will 
cause the privilege violation. External reset will always 
initiate reset exception processing. 

Example : 

If the SR contains H'2011, then 

WAIT #H'2015 

changes the contents of the SR to H'2015 and stops all 
processing until an interrupt is received. 

Condition Codes: 

X N Z V C 



All the flags are set according to #exp, 



Instruction Field: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



1 1 1100111001 



#exp 



The #exp field contains data to be loaded in the status 
register. 
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XOR 
exclusive OR status register 



XORtl] .SR #exp[.W or .L] 



Operand length(l): B, W 



Performs a logical exclusive OR on the immediate expression 
(#exp) and the status register (SR), and stores the result 
in the status register. 



Example: 

IF the SR contains H'2015, then 

XORB .SR, #H'1F 
changes the contents of the SR to H'2#0A. 

Condition Codes: 

X N Z V C 



All the flags are set according to the operation. 

Instruction Field: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 10 






10 


1 





size 


mode 


reg. 


word data 


(16 bits) 













The size field contains the size of the operation. 
If the size field is 00, it is byte. 
If the size field is 01 , it is word. 
If the size field is 10, it is long. 

The register and mode fields contain the destination 
status register 111 100. 

The word data field contains the #exp. 
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APPENDIX A/ Object Code Description 

The object code produced by the assembler-16 serves as input 
to a linker routine before being stored in memory. 

The object code defined here is designed to be compact and 
simple, yet capable of providing for future language 
extensions . 



GENERAL STRUCTURE 

The object code for a program is contained in a single file 
of sequential organization. The file consists of 
sequentially organized groups of data, called plexes, which 
may span record boundaries arbitrarily. 

Each plex contains a byte count as its first character. 
This limits the size of a plex to 255 characters. The byte 
count includes the character containing the byte count. 
Each plex also contains the plex type as its second 
character. Thus, the minimum size for an object code plex 
is two bytes. 

Symbols within the object code are of variable length. In 
conformance with the assembler-16 limit, a maximum of 45 
characters for each symbol is observed. Whenever a symbol 
appears in the object code, the first byte is a count, and 
the subsequent bytes contain the symbol in unpacked format. 



PLEX TYPES 
Define Processor (0) 

Byte(s) Contents 

Plex size = 11 

1 Plex type = 

2 Version = 

3 Language Processor = 

4 Maximum Symbol Size = 45 
5 -10 Date 

The Define Processor (Plex Type 0) group must be the first 
group of an object file. 
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The Version field refers to the version of the object code. 
Subsequent versions may make the prior versions obsolete 
and/or incompatible. The linker can use this information to 
support selected versions. 

The Language Processor field contains a zero for the 
assembler-16 - other language processors will be assigned 
other numbers. 

The Maximum Symbol Size in the object code is currently 45. 
The assembler-16 removes all blanks from symbols. 

The Data refers to the date of object file creation. Date 
is ASCII in the form YYMMDD. 

Define Program Section (1) 

Byte Contents 

Plex Size 

1 Plex Type = 1 
2-3 Section Number 
4-n Section Name 

This plex defines a section of code (Relocatable or 
Absolute ) by name and by number . Subsequent reference to 
this section will be by number alone. The section number is 
unique for each differently named RSECT. An unnamed RSECT 
is given the number 1, and the ASECT is given the number 0. 

Section Name may contain a blank symbol of length 1 (to 
signify unnamed RSECT or ASECT); otherwise, it is the name 
given to the RSECT or ASECT assembly language program. 

The effect of Define Program Section in the linker is to 
select the section as the current section and to set the 
location counter to zero. 

Select Section (2) 

Byte Contents 

Plex Size = 4 

1 Plex Type = 2 
2-3 Section Number 
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This plex selects a section to be the "current" section for 
subsequent object code groups. Only one section can be 
current at any point in the object code. 

Another effect of the Select Section is to quiesce the 
previously current section. The program location counter of 
the quiesced section is not changed by the occurrence of 
this plex. 

The location counter previously current when this section 
was last quiesced becomes the current location counter. 

Select Section ORG (3) 

Byte Contents 

Plex Size = 8 

1 Plex Type = 3 
2-3 Section Number 
4-7 Displacement 

This plex selects a section as current and sets the program 
location counter to a value relative to the beginning of the 
section. 

The Displacement is a 32-bit number which defines the value 
of the new location counter for the section specified. The 
Displacement is relative to the start of the section. 

Define Section Length (4) 

Byte Contents 

Plex Size = 8 

1 Plex Type = 4 
2-3 Section Number 
4-7 Section Length 

This plex type defines the size of the referenced section 
(in bytes). Only one of these plex types per section is 
permitted, and there must be one for each relocatable 
section defined. This is not required for ASECT. 

Define Symbol (5) 

Byte Contents 

Plex Size 

1 Plex Type = 5 
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2-3 

4-7 
8-n 
n+1, 



Section Number 

Value 

Symbol 

More definition groups 



This plex defines the value of a symbol. 

The Section Number identifies the section relative to which 
the symbol is defined. If the definition is an absolute 
number, the Section Number should be zero. 

The Value is 32 bits long and contains an offset from 
section start if Section type is relocatable, or an absolute 
number if Section type is absolute. 

The (Section Number, Value, Symbol) group may be repeated 
within the plex to define arbitrarily many symbols. 

Declare Symbol Reference (6) 

Byte Contents 

Plex Size 

1 Plex Type = 6 
2-3 Symbol Number 
4-n Symbol 

n+1... More reference groups 

This plex declares a symbol as an external-referenced name 
and assigns a number to it for subsequent usage in an object 
code expression. 

The Symbol Number is a two-byte binary value, which is 
unique to this symbol among all symbols in this program 
file. This number is used in object code expressions to 
reference the symbol value. 



As many (Symbol Number, Reference Size, Symbol) 
necessary may follow the first such group. 

Load Constant Data ( 7 ) 



groups as 



Byte 


1 
2-n 



Contents 

Plex Size 
Plex Type 
Date 



= 7 
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This plex loads data at the current location counter and 
increments the location counter by one for each data byte 
loaded. 

Load Constant Repeat Data (8) 

Byte Contents 

Plex Size 

1 Plex Type = 8 
2-5 Repeat Count 

6-n Repeated Constant 

This group loads repetitious data values into memory at the 
current location counter. The value to be repeated may be 
any number (>0) of bytes as computed from the size of the _ 
plex. The pattern is repeated the number of times specified 
in the repeat count. This can be used to repeat bytes, 
words, longwords, text strings, etc. 

Load Data with Reference ( 9 ) 

Byte Contents 

Plex Size 

1 Plex type = 9 

2 Modifiable Field Start 

3 Modifiable Field Size 

4 Skeleton Data Size 
5-n Skeleton Data 
(n+l)-m Object Code Expression 

This plex loads data at the current location counter after 
evaluating an object code expression, including the result 
as part of the data. 

The data to be loaded may be a byte, word, or longword. 

The Modifiable Field Start is the bit number (0-31) within 
the Skeleton data where the modifiable field begins. The 
Modifiable Field Size gives the number of bits in the 
modifiable field, contiguous from Modifiable Field Start. 

The Skeleton Data Size is 1, 2, or 4 for Byte, Word, or 
Longword respectively. The Skeleton Data contains the data 
value to be loaded (1, 2, or 4 bytes). 

The Object Code Expression consists of a byte count followed 
by Polish notation for an expression to be evaluated by the 
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linker, the result of which is stored in the modifiable 
field of the data word. The byte count includes itself. 

The object code expression polish consists of operands and 
operators combined according to the following rules: 

The polish is in the form: 

<operand> 
or <binary operator><operand><operand> 
or <unary operator><operand> 

The <operand> may itself be the polish for an expression, or 
it may be: 

- a binary value 

- an address 

- the value of an external symbol 

If the <operand> is the polish for another expression, then 
the first byte must be an operator. The operators are, 
therefore, numbered from 128 onward to distinguish them from 
operands. The values for the defined operators are given 
below. 

Operands may occupy one or more bytes , dependent upon the 
operand type. The first byte of each operand is the type 
byte. Subsequent bytes define the value associated with the 
operand (if any). 



Operand 
Type 



Byte 
Length 



Meaning 




1 
2 



5 
7 
3 



Binary value 
Address 
External Symbol 



Contents of extra bytes in operand are: 



Binary value 
Address 



4 bytes 32-bit value 

2 bytes section number, 

4 bytes offset 

2 bytes symbol number . 



External Symbol : 

Operator Values and Types 
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Operator 


Value 


Type 


— 


128 


unary 


- 


129 


binary 


+ 


130 


binary 


* 


131 


binary 


/ 


132 


binary 


.AND. 


133 


binary 


• XOR. 


134 


binary 


.OR. 


135 


binary 


.NOT. 


136 


unary 


.SHL. 


137 


binary 


.SHR. 


138 


binary 



The expression is evaluated using 32-bit values and 
accumulators . 

The result must "fit" into the Modifiable Field. Sign 
extension is permitted; if the resultant value X is in the 
range: 

n-1 n-1 

-2 -1 < X < 2 

where n = number of bits in modifiable field. 

Then x is considered to "fit". 

Declare Program Entry Point (10) 

Byte Contents 




1 

2-3 
4-7 



Plex Size = 8 
Plex Type = 10 
Section Number 
Entry offset 



This plex defines the entry point of the program, to which 
control is passed when loading is complete. 

End of File (255) 

Byte Contents 

Plex Size = 3 
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1 Plex Type = 255 

2 Error Indicator 



This plex terminates the program, closes all sections, and 
signals the end of the file. 

The error indicator byte signifies what diagnostics were 
generated by the assembler-16 . 

= clean assembly 

4 = warnings generated 

8 = errors generated 
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APPENDIX B / Memory Map 



BEGINNING OF — > 

MEMORY 



TRSDOS-16 



DEBUG 
IF LOADED 



RUNCOBOL 
IF LOADED 



BASE ADDRESS — > 



USER 
MEMORY 



BOUNDS ADDR — > 

User memory begins at H'500J2f if the Debugger is not configured 
and at H'6000 if the Debugger is configured. 
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APPENDIX C/ SAMPLE PROGRAMS 



PROGRAM 1: Simple 16 Bit Binary Addition 

This program adds the contents of one memory word (NUMl) to 
another (NUM2), and stores the result in a long word (SUM). 





RSECT 




NUMl 


DATAW 


H'10FB 


NUM2 


DATAW 


H*FF17 


SUM 


RESL 


1 


BEGIN 


CLRL 


.D0 




LDW 


.D0,/NUMl 




ADDW 


.D0,/NUM2 




STL 


.D0,/SUM 




END 


BEGIN 



Clear D0 

Put the word at NUMl into D0 
Add the word at NUM2 to D0 
Store the long word at SUM 



After execution of this program, the number H'^Wl 1012 is 
stored in the memory location associated with SUM. 



PROGRAM 2: 



BCD Addition 



This program adds two binary coded decimals (BCD's) stored 
in NUMl and NUM2, and stores the result in a third memory 
location SUM. (Note: Remember that all BCD arithmetic is 
byte size only! ) 





RSECT 




NUMl 


RESB 


1 


NUM2 


RESB 


1 


SUM 
* 


RESB 


1 


BEGIN 


CLRL 


.D0 




LDB 


.D0,/NUMl 




LDB 


.D1,/NUM2 




ADDD 


.D0, .Dl 




STB 


.D0,/SUM 




END 


BEGIN 



Load the number at NUMl into D0 
Load the number at NUM2 into Dl 
Add the two numbers 
Store the resulting byte in SUM 



PROGRAM 3: Search a Table 
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This program searches a TABLE for an ITEM. The word size 
elements of TABLE are arranged in ascending order, with the 
first word being the number of elements in the TABLE. If 
the ITEM is found, its number in the TABLE is returned as 
ITEMNO. If no match is found, then ITEMNO is set to H'FF. 



ITEM 


RESW 


1 


TABLE 


DATAW 


H^H'^H'l 


ITEMNO 
* 


RESB 


1 


BEGIN 


LDL 


.A0,# TABLE 




LDW 


.D0,@A0+ 




ADDL 


.A0,.D0 




ADDL 


.A0,.D0 




SUBW 


.D0,#1 




LDB 


.D2,#FF 




LDW 


.D1,/ITEM 


LOOP 


CMPW 


.Dl,-§A0 




DBGE 


•D0,LOOP 




BNE 


DONE 




MOVB 


.D2, .DJ2f 


DONE 


STB 


.D 2, /ITEMNO 




END 





Put start address of TABLE in A0 
Put number of elements in D0 
Point A0 1 word past last elementof 
of TABLE (twice since word=2 bytes) 
Setup D0 for DB instruction 
Assume that no match will be made 
Put ITEM into D0 

Check element pointed to by A0; if 
D0 <> -1 and Dl < element, continue 
If not equal then branch to DONE 
Else move element number to D2 
Store element number in ITEMNO 



If ITEM equals H'15, then after execution of the program, 
ITEMNO contains H'02; if ITEM equals H'36, then ITEMNO is 
set to H'FF. 



PROGRAM 4: Convert ASCII to binary 

This program converts an ASCII coded decimal to its binary 
value. The program has two basic steps, first, conversion 
of the ASCII coded decimal into a binary coded decimal, and 
second, conversion of that BCD into its binary equivalent. 
Step 1 is accomplished by subtracting #H'30 from the ASCII 
number (for example, the ASCII code for 7 is H'37, so H'37 - 
H' 30 = H 1 01 ) . To accomplish step 2, we simply multiply the 
BCD by a power of 10 based on its position in the ASCII 
string . 



ASCINT 

HEXNUM 
* 



ASECT 
ORG 
RESL 
RESW 



H ' 4000 

1 

1 
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BEGIN 



LOOP 



CLRL 

LDL 

LDA 

LDB 

SUBB 

MULU 

ADDL 

MULU 

CMP 

BNE 

STW 

END 



.D2 

.D0,#1 

.A0,ASCINT+4 

.Dl,-@A0 

.Dl,#H'30 

. Dl, .D0 

,D2,.Dl 

.D0,#10 

.A0,#ASCINT 

LOOP 

.D2,/HEXNUM 

BEGIN 



Clear the sum register (D2) 

Set initial power of 10 to 1 

Put address of 4 past ASCINT in A0 

Get byte of ASCINT (start from left) 

Convert to BCD 

Multiply by power of 10 

Add product to sum 

Raise D0 to next power of 10 

Check to see if at leftmost byte 

If not, then continue 

Else store sum in HEXNUM 



If ASCINT contains "1245" (coded H'31 32 34 35), then at the 
end of the program, HEXNUM contains H'04DD. 

PROGRAM 4A: Program 4 as a subroutine 

Program 4 represents a commonly used routine. For example, 
after inputting a number with the KBLINE SVC, you might need 
to perform an arithmetic operation with it. But to use it, 
you must first convert the ASCII code, which the SVC 
returns, to a binary number, which the computer uses. 

In this example, the subroutine requires that a KBLINE SVC 
has just been executed successfully. The subroutine 
processes the number just as in Program 4, and returns the 
binary number to the calling program by putting it at the 
top of the user stack (A7). 

(Note: The 68000 limits multiplication to single word 
operands; however, to convert a large number, we need power 
of ten which takes up more than one word. To overcome this, 
we simply treat the multiplicand, i.e., the power of ten, as 
two separate words . 

We then multiply the BCD by the low word, store it, and then 
shift the high word into the low word. The BCD is again 
multiplied by this word, but before we add it to the 
low-word -product we shift it back to the high word. 

For simplicity's sake, we limit the input number to less 
than 9 characters, so that we keep the shifted high word 
product in one register. However, if you need to convert a 
longer number, then you may use more than one register to 
contain the operands and the product. 
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♦Subroutine ASCII TO HEX 
* 

* Purpose 

* Convert an ASCII string to its binary numberic value. 
* 

* Entry Conditions 

* An ASCII string has been entered via the KBLINE SVC. 
* 

*Exit Conditions 

* The converted string is put onto the top of the stack. 
* 

♦Limitations 

The value of the ASCII string must lie between -9,999,999 and 
99,999,999. If the string is too large, or if it contains a non- 
numeric character (other than a leading minus sign), the subroutine 
returns H* 8000 0000 to the stack. 



* 
* 
* 
* 
* 

ASCII TO HEX 
STML 
LDW 
LDW 
CMPW 
BGT 
SUBB 
CLRL 
LDL 
LDL 
ADDW 
CMPW 
BNE 
SUBL 
SUBB 



.D0,.D1,.D2,.D3,.D4,.D5, .Al,.A2,-@A7 



,D5,#H'10 

.D4,12@A0 

.D4,H'09 

ERROR 

.D4,#H'01 

.D3 

.Al,# POWERS 

.A2,8@A0 

.A2,12@A0 

14§A0,#H'0D 

NEXT CHARACTER 

.A2,#H'01 

.D4,#H'01 



*Save registers 



*Put shift value into D5 

*Get length of input string 

*Check for too big 

*If too big then branch 

*Else continue; correct for DBC 

*Clear out sums register 

*A1 points to POWERS 

*A2 points to buffer from SVC call 

*A2 points to 1 byte past buffer 

*Check last character for CR 

*If not, then branch 

*Else correct length 

♦Correct counter 



NEXT CHARACTER 
LDB 
SUBB 
BN 

CMPB 
BGT 
LDL 
MOVL 
MULU 
ADDL 
SHRL 
BE 
MULU 



.D0,-@A2 

.D0,#H'30T 

NON NUMERIC 

.D0,#H'09 

ERROR 

.D1,§A1+ 

.D2,.D1 

.Dl,.D0 

•D3,.D1 

.D2,.D5 

NO HIGH 

.D2,.Dj2f 



*Take a byte of the string 

♦Convert ASCII to BCD 

*If negative result, then branch 

♦Compare with high bounds 

*If greater than 9, then branch 

*Get current power of 10 

*Copy Dl in D2 

♦Multiply the BCD by a POWER 

♦Put product in sums register 

♦Move high word to low word 

♦If D2 = 0, then branch 

♦Multiply the BCD by high word 
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jng gn 


SHLL 


.D2,.D5 


ADDL 


.D3,.D2 


NO HIGH 




DBC 


.D 4, NEXT CHARACTER ' 


BR 
* 


SUB DONE 


NON NUMERIC 




ADDB 


.D0,#H'30 


CMPB 


.D0,#H'2D 


BNE 


ERROR ' 


CMPB 


.D0,#H'2D 


BNE 


ERROR ' 


NEGL 


.D3 


BR 


SUB DONE 
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*Shift low word back to high word 
*Add product to sum register 



*If more numbers, then branch 
*Else branch to SUB DONE 



♦Convert BCD back to ASCII 

* Check for negative sign code 

*If not right code, then branch 

*Make sure it's the lefmost byte 

*If not, then branch 

*Else take negative of sum register 

*Branch to SUB DONE 



ERROR 

LDL 
* 

SUB DONE 
STL 
LDML 
RET 

* 

POWERS 

DATAL 
DATAL 



. D 3, #H' 8000000 



* Error code is H'8000 0000 



,D3,H*24@A7 *Return result to stack 
,D0,.Dl,.D2,.D3, .D4,.D5,.A1, .A2,@A7+ *Restore reg's 

*Return to calling routine 



1 , 10 , 100 , 1000 , 10000 , 100000 , 1000000 
10000000 , 100000000 , 1000000000 



Note that the first thing we did was save the contents of 
the registers which the subroutine altered. The STM and LDM 
instructions, in combination with pre-decrement and 
post-increment indirect addresssing work well for this since 
the STW instruction stores from the lowest address register 
to the highest data register, while the LDM instruction 
loads in just the opposite order. 

PROGRAM 5: Converting Hex to ASCII Integer 

The last program described how to convert an ASCII integer, 
presumably entered from the keyboard, into its binary (or 
hex) equivalent. It is also important to be able to do the 
opposite — convert the binary to ASCII integer, so that it 
can be sent to a display. 

To accomplish this, we basically need to run Program 4 in 
reverse. That is, we can divide the binary number by powers 
of ten to give the BCD value of each decimal digit. We then 
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convert the BCD to ASCII by adding H 1 30 , and store the 
values in a string. 

However, as in Program 4A, we run into the problem of size. 
The 68000 can accept division of a long word by a single 
word, resulting in another single word. However, we may 
have some numbers which would result in a quotient longer 
than one word — this would give an overflow error. 

Because of this, we must perform the division by subtracting 
a power of ten, repeatedly (summing the number of times we 
subtract) until the difference is less than that power of 
ten. We then perform the same steps with lower powers of 
ten until the power of ten equals one. The number of the 
subtractions per power gives the BCD for that power. It is 
a simple matter, then, to convert the BCD string into an 
ASCII string by adding H'30 to the BCD. 

* Subroutine HEX TO ASCII 
* 

* Purpose 

* Convert a hexadecimal (binary) number into its ASCII-coded 

* decimal equivalent. 

* Entry conditions 

* The value of the hex number is pushed to the stack , on top of the 

* destination address of the resulting ASCII string. 
* 

*Exit conditions 

* The ASCII string is stored in the memory address specified by the 

* calling program. 
* 

♦Limitations 

* The hex number must evaluate to a decimal value between 

* +/- 10**9. 



HEX TO INT 
STML 
LDA 
LDL 
LDL 
MOVB 
TESTL 
BP 

SUBW 
MOVB 
NEGL 



.D0,.D1, .D2,.A0,.Al,-@A7 *Save registers 

.A0, POWERS 2 *Put address of POWERS 2 in A0 

.Al,H'18@A7 *Get address of ASCII INT off stack 

.D0,H'lC@A7 *Get value of hex number off stack 

@Al+,#H'20 *Store blank for first character 

.D0 * Check hex number for sign 

NEXT POWER *If positive then blank was correct 

.Al,#H'01 *Else move back to first character 

@Al+,#H'2D *Put a negative sign there 

.D0 * Change the hex number to positive 
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NEXT POWER 

LDB 

LDL 
* 

MORE SUBTRACTION 



•D2,#H'30 
.Dl,@A0+ 



CMPL 

BLT 

SUBL 

ADDB 

BR 



,D0,.D1 

NEXT DIGIT 

.D0,.D1 

•D2,#H'01 

MORE SUBTRACTION 



*Set D2 to ASCII 
*Get next power 



zero 



*Check for done with that power 
*If done then branch out of loop 
*Else subtract power from hex num 
*and increment counter 
*Continue subtraction 



NEXT DIGIT 
STB 
CMPB 
BNE 
LDML 
RET 



.D2,@Al+ 
.Dl,#H'01 
NEXT POWER 



. DJZf r .Dl, .D2, .A0, .Al,@A7+ 



*Store counter in ASCII INT string 

* Check for last power 

*If not then do another power 



*Else restore registers 



POWERS 2 

DATAL 
DATAL 



1000000000 , 100000000 , 10000000 , 1000000 , 100000 
1000 ,1000,100, 10,1 



Compare the Program 5 with Program 4A. Note that when we 
loaded the address of POWERS in Program 4A, we used a load 
address register immediate (LDL) instruction, while in 
Program 5 we used a load effective address (LDA) 
instruction. Either is correct. 

Also note that for Program 4A we ordered POWERS in ascending 
order and accessed the elements starting from the front, 
while in Program 5 we ordered P0WERS2 in descending order 
and accessed the elements from back to front. Either is 
just as cOnvienient since the 68000 has auto increment 
(@An+) and decrement (-§An). 

PROGRAM 6: Calling a subroutine 

Programs 4A and 5 were presented as subroutines . It was 
assumed that some other program supplied the subroutine the 
necessary parameters (like the address of ASCII INT, etc.). 
Here is a sample showing what a main program which calls 
these subroutines might look like: 

*Data block 
* 

RSECT 
HEXNUM 



Radio /hack 

334 



ASSEMBLER-16 



RESL 


1 


SVC BLOCK 
RDATA 


32,0 


BUFFER 

RDATA 


80,0 


ASCII INT 
RESB 
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* Program block 



LDA 


.A0,SVC BLOCK 


MOVW 


<§A0,#H'05 


MOVW 


6@A0,#H'09 


MOVL 


8 @Aj?,# BUFFER 


BRK 


#0 


TESTW 


2@A0 


BNE 


ERROR ROUTINE 


SUBL 


.A7,#H'04 


CALL 


ASCII TO HEX 


CMPL 


@A7,#H' 8000000 


BE 


ERROR ROUTINE 


STL 


§A7+,/HEXNUM 


STL 


/HEXNUM,-@A7 


PUSHA 


ASCII INT 


CALL 


HEX TO INT 


MOVW 


@A0,#H'09 


MOVW 


6@A0,#H'0B 


MOVW 


8@A0,#H'0D 


MOVL 


10@A0,#ASCII INT 


BRK 


#0 



*Set up KBLINE SVC 



* Check for SVC error 

*On error branch to ERROR ROUTINE 

*Make space on stack for hex num 

*Call up ASCII TO HEX subroutine 

* Check for subroutine error 

*On error branch to ERROR ROUTINE 

*Pop hex number into HEXNUM 



*Push hex number to stack 
*Put address of ASCII INT on stack 
*Call up HEX TO INT subroutine 
*Set up VDLINE SVC 
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APPENDIX D/ The Configuration Command File 

Whenever TRSDOS-16 starts up or is reset, it looks for a 
file named C0NFIG16/SYS. This "configuration command file" 
tells TRSDOS-16 to link in certain extra operating system 
programs . 

C0NFIG16/SYS should be present on the primary disk device 
(drive or drive 4). It contains these directives: 

INCLUDE RUNCOBOL 
INCLUDE DEBUG 
END 

which tell TRSDOS-16 to link in the RUNCOBOL program and the 
DEBUG program. 

You may create your own C0NFIG16/SYS file, or modify the 
existing one to meet your needs, by using EDIT16. 



SAVING THE EXISTING C0NFIG16/SYS FILE 

Before creating a new C0NFIG16/SYS file, you will probably 
want to save the existing one by renaming it. 

For example: 

RENAME CONFIG16/SYS:J0 TO DEBCOB/CFG :J0 

renames the default configuration file. (The new filename 
tells you it includes both DEBUG and RUNCOBOL modules. 

After renaming the existing C0NFIG16/SYS file, you can 
create a new one. 

Since you "saved" the existing file, you can use it again. 
To do this, rename the present C0NFIG16/SYS file (if you 
want to save it) and then rename DEBCOB/CFG back to 
C0NFIG16/SYS: 

RENAME DEBCOB/CFG :0 TO C0NFIG16/SYS :0 
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TO EDIT OR CREATE CONFIG16/SYS 

Use EDIT16 to edit or create a C0NFIG16 command file. 

1 . Type : 

EDIT16 <ENTER> 
and the Editor's Command mode prompt will be displayed: 

C? 

2. To insert commands into the command file, you must get 
in the Insert mode, type: 

IN <ENTER> 

The Editor will display the I? prompt, indicating that 
you are in the Insert mode. 

3. You are now ready to insert the names of the programs 
you want linked to TRSDOS-16. 

Comments may be used. They are indicated by an 
asterisk (*) in the first column. 

The key word INCLUDE tells TRSDOS-16 the 

name of the program. The syntax for the INCLUDE 

statement is: 

INCLUDE filename 

The default extension for filespec is /SYS; it is 
optional. Drive numbers, disk ID and Passwords are 
not permitted. 

Programs are loaded sequentially in memory in the order 
they are encountered in the C0NFIG16/SYS file. The 
maximum number of programs that may be INCLUDEd is 15. 

The programs must be resident on the primary boot 
device (Drive or Drive 4). 

The list is concluded with an END statement. 

For example : 

* This is the Configuration File for DEBUG 
INCLUDE DEBUG 
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END 

tells TRSDOS-16 to link only the DEBUG program. The 
first line is a comment and is not executed by 
TRSDOS-16 

4. When you are finished inserting, type: 

! <ENTER> 

to exit the Insert Mode. 



5. Save the file with the following command: 

SA C0NFIG16/SYS <ENTER> 

6. You now have a new C0NFIG16 command file that TRSDOS-16 
will use when it powers up or resets. 



CONFIGURATOR ERROR MESSAGES 

When the Configurator lists a line generating an error, it 
prints an error message directly underneath the line number 
Preceding the message, it inserts three asterisks. 

In cases of certain syntax or file I/O errors, the 
Configurator also marks, with a dollar sign ($), where in 
the line the error occurred. 

For example : 

011 INCLUBE RUNCOBOL 

$ 
*** Illegal Command 

shows a syntax error in the spelling of INCLUDE. 

There are three catagories of Configurator error messages: 

A. Configuration Control File Errors 

B. Configuration Command Errors 

C. Completion Errors 
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A. Congifuration Control File Errors 

These errors are FATAL. If one of these errors occur, the 
Configurator could not properly execute the C0NFIG16/SYS 
file. TRSDOS-16 will still be displayed but certain 
defaults will have occured: 

1. No programs have been INCLUDED 

2. DEBUG is kept resident (if available) 

3. Any memory not occupied by DEBUG and the resident 
Operating System is available to the user. 

Use EDIT16 to correct the error (or create a new 
configuration file) and reset the system. 

Can't Open C0NFIG16/SYS: TRSDOS Error Code = nnn 

Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 

Can't configure system: File C0NFIG16/SYS not proper 
format 

The C0NFIG16/SYS file is not a VLR type file. 

Can't configure system: File C0NFIG16/SYS not found 

TRSDOS-16 could not find the C0NFIG16/SYS file. 



I/O Error on File C0NFIG16/SYS: TRSDOS Error Code = nnn 

Look up TRSDOS-16 Error Code nnn in Appendix B and 
take appropriate action. 



B. Configuration Command Errors 

These errors occur when a command cannot be processed by the 
Configurator. If one of these error occurs, the 
Configurator will continue to process the command lines. 
However, the desired result of the configuration file may 
not have been accomplished. For example, an INCLUDE file 
may have been left out. 
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Can't INCLUDE program: TRSDOS Error Code = nnn 

The Configurator cannot load the program because 
of an I/O error. Look up the TRSDOS-16 - Error Code 
in Appendix B. 

Can't INCLUDE program: Out of Memory 

More resident programs were requested than will fit 
into user memory. 

Can't INCLUDE program: Program already configured 

This error occurs any time a program is included twice, 



Too many INCLUDED programs: this request ignored 

This error occurs if more than 15 programs are 
included. The command line that is flagged is ignored 
(treated as a comment). 



C. Completion Error 

*** CONFIGURATION ABORTED *** 

This message appears when the configurator could not 
finish processing the C0NFIG16/SYS file because of 
an I/O error . 

ABOUT THE CONFIGURATOR 



The Configurator is invoked whenever the 6 8 J3T00 processor is 
initialized. It performs several important functions: 

It determines whether the machine debugger is 
required. If not, it is eliminated from memory. 
This gives you an extra 4K of memory. 

It initializes traps and interrupts. This 
eliminates the need to keep extra code resident 
in memory. 
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It loads in resident programs as specified in 
the C0NFIG16/SYS file. 

It reads the AUTO file and passes it to 
TRSDOS-16 for execution. 



The Configurator is linked in at the end of user memory and 
occupies 4K of memory. Upon system initialization, it moves 
itself to the top of physical memory. This is because the 
resident programs will be loaded at low address, overlaying 
the original configurator. 

Next the Configurator begins to load the resident programs 
requested in the C0NFIG16/SYS file (i.e. DEBUG and 
RUNCOBOL) . It loads these programs sequentially starting at 
the beginning of user memory and up to the beginning of 
where the Configurator has relocated itself. This 
guarantees that after loading is complete, the user has at 
least 4K of memory available (the size of the Configurator). 

After configuration is complete, the Configurator is no 
longer neccessary and is overwritten. 
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APPENDIX E/ Additional 68000 Instructions 

The MC68000 microprocessor supports three opcodes in addition 
to those supported by the ASSEMBLER-16. These instrucions are 
BRanch Always (BRA), Branch to SubRoutine (BSR), and Test a 
Bit and Set (BSET) . 

BRA 

BRA is very similar to BR exp(§PC) in that it allows you to 
transfer control of your program unconditional to a PC 
relative address. The major difference between the two 
instructions is that the BRA instruction can use less storage 
space when using an eight-bit displacement because it puts the 
displacement value in the same word as the instruction code, 
thus saving two bytes of storage spaces. 

The BRA instruction may also be used for sixteen-bit 
displacements; however, the displacement is stored in an 
extension word following the instruction field. Like the BR 
instruction, the BRA instruction affects none of the 
conditions codes. 

The instruction field for BRA is: 



15 


14 


13 


12 11 10 9876543210 





1 


1 


8-bit displacement 


16-bit displacement 



For an eight-bit displacement, the second word (containing the 
sixteen-bit displacement) is not necessary. For branches 
using the sixteen-bit displacement, the eight-bit displacement 
field is filled filled with zeroes. 

BSR 

BSR is similar to the CALL exp(§PC) instruction, in that it 
allows you to call a subroutine whose start address can be 
given as a displacement relative to the program counter. As 
with CALL, the computer first pushes the address of the 
instruction following the BSR onto the stack. Also like CALL, 
BSR changes none of condition codes. 

The major difference between CALL and BSR is that the _ BSR 
instruction may only be one word long when an eight-bit 
displacement is specified. For a sixteen-bit displacement, 
two words are used, the second word holding the displacement 
value. 



Radio /hack 



342 



ASSEMBLER-16 



TRS-BO 



® 



APPENDICES 



The instruction field for BSR is: 



15 


14 


13 


12 11 10 9876543210 





1 


1 


8-bit displacement 


16-bit displacement 



For an eight-bit displacement, the second word (containing the 
sixteen-bit displacement) is not necessary. For subroutine 
calls using the sixteen-bit displacement, the eight-bit 
displacement field is filled with zeroes. 

BSET 

BSET is similar to the other MC68000 bit-test instructions. It tests 
a specific bit of the operand, records the result in the zero bit of 
the condition codes, and then sets the specified bit. You may 
specifiy the bit-number (i.e., the number of the bit to be tested) 
either from a data register or as an immediate value. The instruction 
field for the former is: 



15 14 13 12 11 10 



8 



10 



Rs 



Reg 



3 2 10 
Mode | 



where Rs is a data register containing the bit number. The 
instruction field for the immediate version is: 





15 


14 


13 


12 


11 10 9 8 7 


6 


5 4 3 


2 1 














1 1 


1 


Reg 


Mode 


Bit number 



The condition codes for BSET are: 
X N Z V C 



_ _ * 



N Not affected 

Z Set if the bit tested is zero, cleared otherwise 

V Not affected 

C Not affected 

X Not affected 
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